Prizes

List prize inventory (admin)

get

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

pagenumberOptional

Page number (default: 1)

Example: 1

pageSizenumberOptional

Number of items per page (default: 10)

Example: 10

sortstringOptional

Sort field and order. Use - prefix for descending. Example: -createdAt, createdAt

Example: -createdAt

selectstringOptional

Fields to select (comma separated). Use + prefix to include hidden fields. Example: name,status,+holders

populatestringOptional

Relations to populate (comma separated). Example: wallet,token

Responses

200Success

No content

get/api/prizes

HTTPcURLJavaScriptPython

GET /api/prizes HTTP/1.1
Host: api.radfi.co
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200Success

No content

Seed a Bound Bunny prize into inventory (admin)

post

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

prizeNumbernumberRequired

Prize number (1..100)

Example: 1

namestringRequiredExample: Bound Bunny #001

inscriptionIdstringRequired

Ordinal inscription id

Example: a1a1a1...a1a1a1i0

controllingUtxostringRequired

Treasury UTXO holding the inscription (txid:vout)

Example: a1a1a1...a1a1a1:0

Responses

201Success

No content

post/api/prizes

HTTPcURLJavaScriptPython

POST /api/prizes HTTP/1.1
Host: api.radfi.co
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 117

{
  "prizeNumber": 1,
  "name": "Bound Bunny #001",
  "inscriptionId": "a1a1a1...a1a1a1i0",
  "controllingUtxo": "a1a1a1...a1a1a1:0"
}

201Success

No content