Buy edition

Builds the transactions that print quantity copies (1 to 25) of masterEdition for buyer, one transaction per copy. Each comes with the mintAccount of the copy it prints.

For a gated sale, pass whitelistMint or whitelistCoreCollection; wallet allowlists are checked automatically. If the response includes setupTx, send and confirm it before the others.

To pay with a different token than the listing's currency, pass a swapQuote that covers the price plus 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?

A Jupiter swap quote, passed through as Jupiter returned it.

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

Priority fee per transaction, in lamports. By default it is a cap: mallow pays what the network currently needs, up to this amount (50,000 when omitted). Set exactPriorityFee to pay exactly this amount instead. The fee is never less than 15,000 lamports.

Formatuint64

exactPriorityFee?boolean

Pay targetPriorityFeeLamports exactly instead of treating it as a cap. Defaults to false.

blockhash?string

Recent blockhash to build the transaction with (base58). Omit it to let mallow supply one; identical requests a few seconds apart then return the same transaction.

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

403application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`