> For the complete documentation index, see [llms.txt](https://docs.radfi.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.radfi.co/dev/api-endpoints/prizes.md).

# Prizes

## GET /api/prizes

> List prize inventory (admin)

```json
{"openapi":"3.0.0","info":{"title":"Radfi API","version":"1.0"},"servers":[{"url":"https://api.radfi.co","description":"Production"}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}}},"paths":{"/api/prizes":{"get":{"operationId":"PrizeController_list","summary":"List prize inventory (admin)","parameters":[{"name":"page","required":false,"in":"query","description":"Page number (default: 1)","schema":{"type":"number"}},{"name":"pageSize","required":false,"in":"query","description":"Number of items per page (default: 10)","schema":{"type":"number"}},{"name":"sort","required":false,"in":"query","description":"Sort field and order. Use - prefix for descending. Example: -createdAt, createdAt","schema":{"type":"string"}},{"name":"select","required":false,"in":"query","description":"Fields to select (comma separated). Use + prefix to include hidden fields. Example: name,status,+holders","schema":{"type":"string"}},{"name":"populate","required":false,"in":"query","description":"Relations to populate (comma separated). Example: wallet,token","schema":{"type":"string"}}],"responses":{"200":{"description":""}},"tags":["prizes"]}}}}
```

## POST /api/prizes

> Seed a Bound Bunny prize into inventory (admin)

```json
{"openapi":"3.0.0","info":{"title":"Radfi API","version":"1.0"},"servers":[{"url":"https://api.radfi.co","description":"Production"}],"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http"}},"schemas":{"SeedPrizeDto":{"type":"object","properties":{"prizeNumber":{"type":"number","description":"Prize number (1..100)"},"name":{"type":"string"},"inscriptionId":{"type":"string","description":"Ordinal inscription id"},"controllingUtxo":{"type":"string","description":"Treasury UTXO holding the inscription (txid:vout)"}},"required":["prizeNumber","name","inscriptionId","controllingUtxo"]}}},"paths":{"/api/prizes":{"post":{"operationId":"PrizeController_seed","summary":"Seed a Bound Bunny prize into inventory (admin)","parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SeedPrizeDto"}}}},"responses":{"201":{"description":""}},"tags":["prizes"]}}}}
```