Accept offer

Builds a transaction in which seller accepts buyer's outstanding offer on asset, transferring the asset and releasing the escrowed funds.

seller must currently own the asset and an offer from buyer must exist; both failures return 400. If the asset is simultaneously listed for a fixed price by the same seller, a delist instruction is prepended automatically, because the on-chain program requires the listing to be closed first.

Set enablePrimarySplit to split the primary-sale proceeds among the creators recorded on-chain. When it is omitted the proceeds go to the seller, with royalties still paid to those creators.

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Accepts an outstanding offer, transferring the asset and releasing the escrowed funds. If the asset is also listed at a fixed price by the same seller, a delist instruction is prepended automatically.

seller*string

Wallet accepting the offer (base58). Must currently own the asset and signs the transaction.

buyer*string

Wallet whose outstanding offer is being accepted (base58).

asset*string

Mint address of the artwork being sold (base58).

enablePrimarySplit?boolean

Split the primary-sale proceeds among the on-chain creators by their shares. Omitted or false pays the seller instead, with royalties still going to the creators.

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/offers/accept" \  -H "Content-Type: application/json" \  -d '{    "seller": "string",    "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`