mallow docs
v1Marketplace

Draw a Jellybean

POST
/v1/getDrawJellybeanTxs/{jellybeanKey}

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

jellybeanKey*string

Address of the jellybean 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/getDrawJellybeanTxs/string" \  -H "Content-Type: application/json" \  -d '{    "buyer": "string"  }'
{  "result": {    "txs": [      "string"    ],    "swapTx": "string",    "swapTxReason": "size"  }}

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.

Scheduled bids for a bidder GET

Returns a bidder's last 100 scheduled bids. Bids in the deposit-confirmed state can be canceled by the bidder using the POST /scheduledBids/getCancelBidTx endpoint.