Cancel offer

Builds a transaction closing buyer's open offer on asset and refunding the escrowed funds to them.

buyer must be the wallet that created the offer, and asset must match the asset recorded on the offer — a mismatch is rejected rather than silently closing a different offer.

This route returns 404 when no offer exists. Note the asymmetry: /v2/tx/offers/accept returns 400 in the same situation.

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Closes an open offer and refunds the escrowed funds to the buyer.

buyer*string

Wallet that created the offer (base58). The escrowed funds are refunded to it.

asset*string

Mint address the offer was made on (base58). Must match the offer, or the request is rejected.

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/cancel" \  -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`