mallow docs
v1Marketplace

Bid or buy

POST
/v1/getBidOrBuyTx

Generates a base64-encoded VersionedTransaction for bidding on an auction or buying from the marketplace. The transaction must be signed and sent by the buyer.

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Whether this bids or buys is decided by how the artwork is listed — auctions get a bid, fixed-price listings get a purchase.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/getBidOrBuyTx" \  -H "Content-Type: application/json" \  -d '{    "buyer": "string",    "mint": "string"  }'
{  "result": {    "tx": "string"  }}

Marketplace

Buy, bid, scheduled bids, and gumball/jellybean draws.

Draw a Gumball POST

Normally returns the draw transactions in txs. When a swapQuote is supplied and the swap cannot be bundled with the draw, the response is a two-call protocol instead: txs is empty and swapTx holds the swap alone. Sign it, send it, wait for confirmed, then call this endpoint again with swapQuote omitted — the buyer now holds the tokens, so the second call returns the draw transactions.