> 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/drops.md).

# Drops

## GET /api/drops/current

> Current live drop summary (pool, countdown, prizes remaining)

```json
{"openapi":"3.0.0","info":{"title":"Radfi API","version":"1.0"},"servers":[{"url":"https://api.radfi.co","description":"Production"}],"paths":{"/api/drops/current":{"get":{"operationId":"OrdinalDropController_current","summary":"Current live drop summary (pool, countdown, prizes remaining)","parameters":[],"responses":{"200":{"description":""}},"tags":["drops"]}}}}
```

## GET /api/drops

> Completed drop history (winners, seed block + hash)

```json
{"openapi":"3.0.0","info":{"title":"Radfi API","version":"1.0"},"servers":[{"url":"https://api.radfi.co","description":"Production"}],"paths":{"/api/drops":{"get":{"operationId":"OrdinalDropController_history","summary":"Completed drop history (winners, seed block + hash)","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":["drops"]}}}}
```

## GET /api/drops/derivation

> Published winner-derivation formula

```json
{"openapi":"3.0.0","info":{"title":"Radfi API","version":"1.0"},"servers":[{"url":"https://api.radfi.co","description":"Production"}],"paths":{"/api/drops/derivation":{"get":{"operationId":"OrdinalDropController_derivation","summary":"Published winner-derivation formula","parameters":[],"responses":{"200":{"description":""}},"tags":["drops"]}}}}
```

## POST /api/drops/claim

> Daily check-in claim — reveals today’s tickets

```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/drops/claim":{"post":{"operationId":"OrdinalDropController_claim","summary":"Daily check-in claim — reveals today’s tickets","parameters":[],"responses":{"201":{"description":""}},"tags":["drops"]}}}}
```

## GET /api/drops/claim/status

> Whether the daily claim is available + your tickets

```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/drops/claim/status":{"get":{"operationId":"OrdinalDropController_claimStatus","summary":"Whether the daily claim is available + your tickets","parameters":[],"responses":{"200":{"description":""}},"tags":["drops"]}}}}
```

## GET /api/drops/{dropNumber}

> Single drop detail

```json
{"openapi":"3.0.0","info":{"title":"Radfi API","version":"1.0"},"servers":[{"url":"https://api.radfi.co","description":"Production"}],"paths":{"/api/drops/{dropNumber}":{"get":{"operationId":"OrdinalDropController_byNumber","summary":"Single drop detail","parameters":[{"name":"dropNumber","required":true,"in":"path","schema":{"type":"number"}}],"responses":{"200":{"description":""}},"tags":["drops"]}}}}
```