API referenceEndpointsRaffles
Get a raffle, with payment parameters
GET
Full raffle detail including prizes and the payment block.
Read payment at purchase time. Never hardcode treasury_ata, usdc_mint
or memo_prefix. For the checkout flow, use the checkout response's exact
payment.memo instead of constructing a memo from this raffle response.
PartnerApiKeyheader
AuthorizationBearer <token>Authorization: Bearer <your_api_key>
Keep this credential on your server, never in browser or mobile app code.
A missing, invalid or disabled key returns 401 PLATFORM_KEY_INVALID.
Ask Verity to replace a lost or exposed key.
raffleId*integerRange
1 <= valueOK
application/json- response
success*booleandata*A raffle as your platform sees it. Verity's own margin config is never exposed.
curl -X GET 'https://api-staging.theverity.xyz/api/v1/platform/raffles/77' \ -H 'Authorization: Bearer <your_partner_api_key>'Example Response
{ "success": true, "data": { "id": 77, "name": "Submariner Drop", "ticket_price_usd": "50.00", "status": "live", "tickets_sold": 4210, "buyback_enabled": true, "buyback_rate_pct": 85, "buyback_window_hours": 24, "per_wallet_limit": 50, "prizes": [ { "id": 41, "draw_order": 1, "prize_item": { "id": 9, "name": "Rolex Submariner 124060", "description": null, "item_type": "watch", "category": "Rolex", "attributes": [ { "key": "reference", "label": "Reference", "value": "124060" }, { "key": "case_diameter", "label": "Case Diameter", "value": "41 mm" }, { "key": "box_papers", "label": "Box & Papers", "value": "Full Set" } ], "market_value_usd": 12500, "image_urls": [ "https://cdn.example.com/sub.png" ] }, "winner": null, "drawn_at": null, "distributed_at": null, "bought_back_at": null, "mint_status": "pending", "mint_address": null, "distribution_status": "not_started", "fairness": null } ], "payment": { "treasury_ata": "9xQeWvG816bUx9EPa2p1vN1ojrEkG1sPjW6MjdrHTGqm", "usdc_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "decimals": 6, "memo_prefix": "rarible:77" } }}