One Levels round
get/v1/levels/rounds/{id}
https://data.decryptr.ai/v1/levels/rounds/{id}
- API planPro and above
- Scope
levels:read - Cost1 unit, also when not found. How units are counted
Rate limits by plan
| Plan | Units a month | Per second | Per minute | Most per request |
|---|---|---|---|---|
| Pro | 300,000 | 15 | 300 | 50 |
| Business | 1,500,000 | 40 | 900 | 100 |
| Enterprise | Agreed | Agreed | Agreed | Agreed |
A 429 carries the full rate-limit header set and a Retry-After. Rate limits
Errors
- 400The request was refused before any data was read. Nothing is charged.
- 401No usable key. Nothing is charged.
- 402The account cannot use the API until billing is sorted. Nothing is charged.
- 403The key may not use this endpoint. Nothing is charged.
- 404No such item. A lookup is still charged what it asked for.
- 429A limit was reached (units or streams). Nothing was read and nothing is charged. Wait Retry-After seconds, back off with jitter, or ask for fewer items.
- 500Something failed on our side. Nothing is charged. Retry with backoff.
- 503The API is switched off, busy, or a query ran too long. Nothing is charged. Retry after Retry-After seconds.
Errors follow RFC 9457. Every error code
One Levels round by id. Rounds that have not locked are not found.
Cost: 1 unit, also when not found.
Needs scope levels:read and the pro plan or above.
AuthorizationBearer <dcr_live_<8 hex>_<43 base64url> or dcr_test_...>Your API key as a Bearer token: Authorization: Bearer dcr_live_....
id*stringRound id.
uuidOK.
application/json- response
data*A round of Decryptr Levels, the daily game where players draw where an asset will go, after it locks. Vote counts are on-time entries only and null under 20 entries. The market's move is given as a label and a percentage; prices are not included.
as_of*stringWhen the response was made.
date-timedisclaimer*stringPlain-language notice. Information only, not financial advice.
curl -X GET 'https://data.decryptr.ai/v1/levels/rounds/00000000-0000-4000-8001-000000000002'{ "data": { "id": "00000000-0000-4000-8001-000000000002", "asset": "ETH", "region": "eu", "opens_at": "2026-10-23T04:00:00.000Z", "locks_at": "2026-10-23T06:00:00.000Z", "resolves_at": "2026-10-23T10:00:00.000Z", "status": "resolved", "entries": 15, "crowd": null, "outcome": "up", "move_pct": 0.30000000000000004, "crowd_correct_pct": null }, "as_of": "2026-10-23T12:24:30.000Z", "disclaimer": "Crowd and model output, not a recommendation. Information only, not financial advice."}Levels rounds and crowd split GET
Rounds of Decryptr Levels, newest first, once each has locked: how many played, how the crowd split, which way the market went and by how much (percent), and the share of the crowd that called it. Splits need 20 entries. No prices. Cost: 1 unit per item returned, at least one item's worth. The request first reserves limit x 1 unit (and is refused with 429 if that many are not available), then pays only for what came back. Needs scope `levels:read` and the pro plan or above.
Levels leaderboard GET
Person-level data (on since 23 Oct 2026): only public accounts that have not opted out (API visibility), never private, banned or suspended accounts, and only content created on or after Decryptr's content date. Authors carry a pseudonymous id (trd_). When content is deleted, hidden or its author leaves, /v1/tombstones lists it: delete your copy within 24 hours. The Levels board: players' average and best scores over resolved rounds in the window (on-time entries, 3 rounds or more). Never drawn paths. Cost: 1 unit per item returned, at least one item's worth. The request first reserves limit x 1 unit (and is refused with 429 if that many are not available), then pays only for what came back. Needs scope `levels:read` and the pro plan or above.