mallow docs
v2 (Beta)TransactionsGumball

Add gumball item

POST
/v2/tx/gumball/add-item

Builds the transaction adding asset to gumballMachine, signed by seller, who must own it. Supports nft, pnft, core, cnft and cnft-v2.

NFTs and Core assets stay in the seller's wallet, locked until they are sold or removed. Compressed NFTs are held by the machine. An asset that is already locked or delegated elsewhere is rejected.

Authorization

ApiKeyAuth
x-api-key<token>

In: header

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/v2/tx/gumball/add-item" \  -H "Content-Type: application/json" \  -d '{    "seller": "string",    "gumballMachine": "string",    "asset": "string"  }'
{  "result": {    "tx": "string",    "setupTx": "string"  }}

Claim raffle proceeds POST

Builds the transaction that pays a finished raffle's ticket revenue to creator, who signs. The marketplace fee and creators' royalties are deducted. The prize is delivered separately, with POST /v2/tx/raffles/claim-prize.

Request gumball item POST

Builds a request, signed by seller, to add asset to another creator's gumballMachine. The item is held as if it were added until the machine's authority approves or rejects the request. Supports the same standards as POST /v2/tx/gumball/add-item.