Buy edition

Builds the transactions that print quantity copies of masterEdition for buyer.

This returns one transaction per copy: { "result": [{ "mintAccount": "...", "tx": "..." }] }. Each mintAccount is the ephemeral print-mint address that its transaction is already partially signed for, so the transactions are not interchangeable — broadcast each one and use mintAccount to reconcile which print resulted.

quantity must be between 1 and 25. Whitelist gating is available through whitelistMint or whitelistCoreCollection; a wallet-allowlisted sale proves membership automatically.

A wallet-allowlisted sale may also need a per-buyer proof account. When it does, the response carries a setupTx alongside result — sign, send and confirm it first, then broadcast the result transactions.

As with a single buy, the buyer pays in the listing's currency; swapQuote is only needed to pay with a different token, and here it must cover the listing price plus estimated SOL fees.

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Prints copies of a master edition. Returns one transaction per copy, paid in the listing's currency. Supply a swapQuote only to pay with a different token, in which case it must cover the listing price plus estimated SOL fees.

buyer*string

Wallet buying the prints (base58). Signs and pays for the transactions.

masterEdition*string

Mint address of the master edition being printed from (base58).

quantity*integer

Number of copies to print. Must be between 1 and 25.

Formatuint32

maxPrice?integer

Slippage guard, in the listing currency's base units. The build fails rather than filling if the listing price exceeds it.

Formatuint64

swapQuote?

Swap quote response (passed through to the swap). Jupiter-shaped; source: "orca" quotes additionally carry poolAddress and platformFee.

whitelistMint?string

Token mint the buyer must hold to pass a token-gated edition's allowlist (base58).

whitelistCoreCollection?string

Core collection the buyer must hold an asset from to pass the allowlist (base58).

targetPriorityFeeLamports?integer

Total priority fee to target for this transaction, in lamports. The builder derives the compute-unit price from it and the transaction's compute budget. Omit to let mallow pick a fee from current network conditions.

Formatuint64

blockhash?string

Recent blockhash to stamp onto the transaction, base58. Omit to let mallow supply one — mallow's is cached for up to 10 seconds, so two identical requests inside that window compile the same transaction, with the same signature once signed. Supply your own to control the expiry window, or when otherwise-identical requests must produce distinct transactions. Rejected with a 400 if it is not valid base58; a blockhash the cluster has already aged out builds fine and fails at send time.

Response Body

`application/json`

curl -X POST "https://example.com/v2/tx/fixed-price/buy-edition" \  -H "Content-Type: application/json" \  -d '{    "buyer": "string",    "masterEdition": "string",    "quantity": 0  }'

{  "result": [    {      "mintAccount": "string",      "tx": "string"    }  ],  "setupTx": "string"}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`