mallow docs
v1Marketplace

Draw a Gumball

POST
/v1/getDrawGumballTxs/{gumballKey}

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.

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Path Parameters

gumballKey*string

Address of the gumball machine (base58).

Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/getDrawGumballTxs/string" \  -H "Content-Type: application/json" \  -d '{    "buyer": "string"  }'
{  "result": {    "txs": [      "string"    ],    "swapTx": "string",    "swapTxReason": "size"  }}

Bid or buy POST

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.

Draw a Jellybean 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.