v1

latestOpenAPI 3.1.0Public2026-07-1316041.2 KB

Lottery

Build an unsigned lottery ticket transaction

Builds transaction data for buying a lottery ticket. Polygon returns a native POL value transaction. Base returns a USDC approval transaction plus a zero-value ticket purchase transaction.

post/api/lottery/build-ticket-tx

Request body

chain'polygon' | 'base'

wallet_addressstring required

numbersinteger[] required

referral_idstring

Optional Base referral ID as 0x bytes32 or a short code up to 32 characters.

Example request

{
  "wallet_address": "0x000000000000000000000000000000000000dEaD",
  "numbers": [
    1,
    2,
    3,
    4,
    5,
    6
  ]
}

Response

Unsigned transaction payloads ready for wallet signing