Fixed-price buy

Builds a purchase of asset at its listed price, signed and paid for by buyer. Set maxPrice to fail rather than pay more than you expect.

The buyer pays in the listing's currency. To pay with a different token, pass a Jupiter swapQuote whose outputMint is the listing's currency. For some assets the swap can't fit in the purchase transaction, and the response contains swapTx instead of tx: send it, wait for confirmation, then call this endpoint again without swapQuote.

A whitelisted listing rejects buyers who aren't on its list.

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Buys a listed artwork at its listed price, paid in the listing's currency. Supply a swapQuote only to pay with a different token; its outputMint must match the listing currency and cover the price.

buyer*string

Wallet making the purchase (base58). Signs and pays for the transaction.

asset*string

Mint address of the listed artwork (base58).

maxPrice?integer

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

Formatuint64

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.

swapQuote?

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

Response Body

`application/json`

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

{  "result": {    "creatorRentTopUpLamports": "string",    "tx": "string",    "swapTx": "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`