Trader sentiment for several assets
get/v1/sentiment/callers
https://data.decryptr.ai/v1/sentiment/callers
- API planDeveloper, and every plan above it. Data is 60 minutes behind live on this plan.
- Scope
sentiment:read - Cost1 unit per id asked for, found or not. 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.
- 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
The latest day of trader sentiment for several assets at once: how many community traders had a live trade and the share that were long, overall and among proven traders. Figures resting on under 10 traders are null. Assets with no data come back in missing and are still charged.
Cost: 1 unit per id asked for, found or not.
Needs scope sentiment: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_....
assets*stringComma-separated asset symbols, 1 to 100 and no more than your plan's max_page, no repeats.
length <= 4000OK.
application/json- response
data*array<>as_of*stringWhen the response was made.
date-timemissing*array<string>Assets asked for with no data. Still charged.
disclaimer*stringPlain-language notice. Information only, not financial advice.
curl -X GET 'https://data.decryptr.ai/v1/sentiment/callers?assets=BTC%2CETH%2CSOL'{ "data": [ { "asset": "BTC", "day": "2026-10-23", "callers": 10, "long_pct": 40, "proven_callers": null, "proven_long_pct": null, "updated_at": "2026-10-23T20:00:00.000Z" }, { "asset": "ETH", "day": "2026-10-23", "callers": 11, "long_pct": 47, "proven_callers": 11, "proven_long_pct": 46, "updated_at": "2026-10-23T20:00:00.000Z" } ], "missing": [ "DOGE" ], "as_of": "2026-10-23T12:12:30.000Z", "disclaimer": "Crowd and model output, not a recommendation. Information only, not financial advice."}Trades in an economic event room GET
Trades logged in an economic event room: how many, how many traders, the long share and, once scored, the share that was right. Counts are null under 10 traders. Cost: 1 unit, also when not found. Needs scope `calls:read` and the pro plan or above.
Trader sentiment per day GET
Trader sentiment for one asset, per day, newest first. Figures resting on under 10 traders are null. Crowd output, not a recommendation. 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 `sentiment:read` and the developer plan or above.