Accept offer

Builds a transaction in which seller accepts buyer's offer on asset. The asset goes to the buyer and the escrowed funds to the seller, less fees and royalties.

seller must own the asset. If they also have it listed at a fixed price, the listing is cancelled in the same transaction, except for compressed NFTs, whose listing must be cancelled first.

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Accepts an offer, sending the asset to the buyer and the escrowed funds to the seller.

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

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

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