Place bid

Builds a bid of bidAmount on asset's auction, signed and funded by bidder. The previous high bidder is refunded on-chain when this confirms.

bidAmount must be a positive integer in the auction's bid currency and must clear the reserve price and the current bid plus its minimum increment.

Assets behind an off-chain allowlist reject bidders who are not on it. A mint mallow has never indexed, or one with no auction, returns 400 (not 404).

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Places a bid on an auction. The previous high bidder is refunded on-chain when this transaction confirms.

bidder*string

Wallet placing the bid (base58). Signs and funds the transaction.

asset*string

Mint address of the artwork under auction (base58).

bidAmount*integer

Bid amount in the auction's bid currency base units. Must be a positive integer that clears both the reserve price and the current bid plus its minimum increment.

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.

Response Body

`application/json`

curl -X POST "https://example.com/v2/tx/auctions/bid" \  -H "Content-Type: application/json" \  -d '{    "bidder": "string",    "asset": "string",    "bidAmount": 0  }'

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