mallow docs
v1Marketplace

Draw a Jellybean

POST
/v1/getDrawJellybeanTxs/{jellybeanKey}

Builds the buyer's draw transactions. Have the buyer sign them, then post them to POST /v1/sendDrawJellybeanTxs/{jellybeanKey}. mallow has to co-sign them, so don't send them yourself.

When paying with a swapQuote, the response may contain only a swapTx. Send it, wait for confirmation, then call this endpoint again without swapQuote.

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

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

Gumball draw status POST

Returns the outcome of draws that came back with a pendingId. Poll about every two seconds until each resolves to a txId or an error. An id can be checked for five minutes.

Send signed jellybean draws POST

Co-signs and sends draw transactions signed by the buyer. Post the transactions from POST /v1/getDrawJellybeanTxs/{jellybeanKey} exactly as returned apart from the buyer's signature, before their blockhash expires. mallow sends each one after a short random delay, so the buyer can't influence which item is drawn.