Fixed-price buy

Builds a purchase of asset at its listed price, signed and paid for by buyer.

maxPrice is a slippage guard — the buy fails rather than filling if the listing price exceeds it.

The buyer pays in the listing's currency. A listing denominated in USDC is bought by spending the buyer's own USDC — no swapQuote, no extra setup.

swapQuote is only for paying with a different token than the listing asks for — SOL for a USDC listing, or vice versa. Fetch a Jupiter quote for inputMint=<the token you want to spend>, outputMint=<the listing's currencyMint> and pass it through. The quote's outputMint must match the listing currency and must yield enough to cover the price, or the request 400s. The buyer remains the sole signer and fee payer.

Listings gated by a whitelist reject buyers who are not on it.

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

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.

swapQuote?

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

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": {    "tx": "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`