mallow docs

Place bid

POST
/v2/tx/auctions/bid

Builds a bid of bidAmount on asset's auction, signed and paid for by bidder. The bid must meet the reserve price and beat the current bid by the minimum increment.

The previous high bidder is refunded when the bid confirms. If their wallet can't receive the refund, it is held for them to withdraw; see GET /v2/auctions/bid-refunds/{bidder}.

Returns 400 if the asset has no active auction, or if the auction is restricted to an allowlist the bidder isn't on.

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.

Response Body

application/json

application/json

application/json

application/json

application/json

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"  }}