Coin snapshot (Decryptr fields)
get/v1/coins/{asset}
https://data.decryptr.ai/v1/coins/{asset}
- API planDeveloper, and every plan above it. Data is 60 minutes behind live on this plan.
- Scope
coins:read - Cost2 units, also when not found. How units are counted
Rate limits by plan
| Plan | Units a month | Per second | Per minute | Most per request |
|---|---|---|---|---|
| Developer | 1,000 | 2 | 20 | 10 |
| Starter | 50,000 | 5 | 60 | 25 |
| 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
Decryptr's own view of one coin: the latest trader split, Decryptr posts in the last 24 hours, the size of its Decryptr community and the latest Levels split. No prices, market cap or volume.
Cost: 2 units, also when not found.
Needs scope coins:read and the developer plan or above.
AuthorizationBearer <dcr_live_<8 hex>_<43 base64url> or dcr_test_...>Your API key as a Bearer token: Authorization: Bearer dcr_live_....
asset*stringAsset symbol, letters and digits, case-insensitive.
^[A-Za-z0-9]{1,15}$OK.
application/json- response
data*Decryptr's own view of one coin. No prices, market cap or volume.
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/coins/BTC'{ "data": { "asset": "BTC", "callers": { "count": 28, "long_pct": 61, "day": "2026-10-23" }, "posts_24h": { "posts": 140, "posters": 52 }, "community_members": 1830, "levels": { "round_id": "00000000-0000-4000-8001-000000000002", "entries": 64, "up": 38, "down": 22, "flat": 4 } }, "as_of": "2026-10-23T12:18:30.000Z", "disclaimer": "Crowd and model output, not a recommendation. Information only, not financial advice."}Trending coins on Decryptr GET
Assets ranked by how many people posted about them on Decryptr in the window, with the change against the window before. Decryptr posts only (never X), from public accounts, outside communities. An asset needs 10 or more posters to be listed. 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 `analytics:read` and the developer plan or above.
Trending topics GET
Trending topics: names and one-line summaries written by Decryptr's model from news and public posts, with counts. Refreshed hourly. Never the source accounts. 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 `analytics:read` and the pro plan or above.