Cancel auction

Builds a transaction cancelling asset's auction and returning the asset to seller. Only an auction with no bids can be cancelled; otherwise wait for it to end and settle it with POST /v2/tx/auctions/settle.

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Cancels an auction and returns the asset to the seller. Only possible while the auction has no bids — once a bid is placed the auction is binding and must be settled instead.

seller*string

Wallet that created the auction (base58). The asset is returned to it.

asset*string

Mint address of the artwork under auction (base58).

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

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