Buy raffle tickets

Builds a purchase of ticketCount tickets in the raffle at raffleKey, signed and paid for by buyer.

Rejected with 400 when the raffle has ended or is sold out, when the purchase would push the wallet past the raffle's per-wallet limit, or past the hard cap of 40% of total tickets per wallet. Holder-only raffles are not yet supported on this route.

When the raffle is denominated in SOL, wrapped-SOL setup instructions (create the token account if needed, transfer, sync) are prepended automatically.

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Buys raffle tickets. For SOL-denominated raffles, wrapped-SOL setup instructions are prepended automatically.

buyer*string

Wallet buying the tickets (base58). Signs and pays for the transaction.

raffleKey*string

Address of the raffle account (base58).

ticketCount*integer

Number of tickets to buy. Rejected if it would push the wallet past the raffle's per-wallet limit, or past the hard cap of 40% of total tickets.

Formatuint32

targetPriorityFeeLamports?integer

Total priority fee to target for this transaction, in lamports. The builder derives the compute-unit price from it and the transaction's compute budget. Omit to let mallow pick a fee from current network conditions.

Formatuint64

blockhash?string

Recent blockhash to stamp onto the transaction, base58. Omit to let mallow supply one — mallow's is cached for up to 10 seconds, so two identical requests inside that window compile the same transaction, with the same signature once signed. Supply your own to control the expiry window, or when otherwise-identical requests must produce distinct transactions. Rejected with a 400 if it is not valid base58; a blockhash the cluster has already aged out builds fine and fails at send time.

Response Body

`application/json`

curl -X POST "https://example.com/v2/tx/raffles/buy-tickets" \  -H "Content-Type: application/json" \  -d '{    "buyer": "string",    "raffleKey": "string",    "ticketCount": 0  }'

{  "result": {    "tx": "string"  }}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`