Public community trades
get/v1/calls
https://data.decryptr.ai/v1/calls
- API planPro and above
- Scope
calls:read - Cost1 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. 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.
- 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
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. Public community trades, newest first: handle, asset, direction, time, horizon, status, outcome, return (a derived percentage) and the trade text.
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 calls: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_....
asset?stringAsset symbol, letters and digits, case-insensitive (BTC, ETH, SOL).
^[A-Za-z0-9]{1,15}$caller?stringOnly trades by this handle.
^[A-Za-z0-9_.]{1,40}$status?stringopen, scored or void.
"open""scored""void"outcome?stringright or wrong.
"right""wrong"since?stringOnly items at or after this time (ISO 8601 with offset). Must be inside your plan's history (Developer 7 days, Starter 30, Pro 365, Business all). Defaults to the start of your history.
date-timeuntil?stringOnly items at or before this time (ISO 8601 with offset). Defaults to now; on Developer it is capped 60 minutes before now.
date-timecursor?stringnext_cursor from the previous page, passed back as it is. Opaque: do not build or change it.
length <= 300limit?integerItems to return, 1 to 100. Your plan allows max_page units per request (Developer 10, Starter 25, Pro 50, Business 100), so at most max_page divided by this endpoint's units per item. Default 20, or that maximum if lower. The request reserves limit x units per item before it runs: ask only for what you need.
1 <= value <= 100OK.
application/json- response
data*array<>as_of*stringWhen the response was made.
date-timenext_cursor*|Pass as cursor for the next page. null when this is the last page.
disclaimer*stringPlain-language notice. Information only, not financial advice.
curl -X GET 'https://data.decryptr.ai/v1/calls?asset=BTC&caller=sample_caller_01&status=scored&outcome=right&since=2026-10-20T00%3A00%3A00Z&until=2026-10-23T12%3A00%3A00Z&cursor=eyJ0IjoiMjAyNi0xMC0yM1QxMDowMDowMC4wMDBaIn0&limit=10'{ "data": [ { "id": "00000000-0000-4000-8003-000000000001", "caller": "sample_caller_01", "asset": "BTC", "direction": "long", "called_at": "2026-10-23T12:00:00.000Z", "horizon_hours": 24, "status": "open", "outcome": null, "return_pct": null, "scored_at": null, "text": null }, { "id": "00000000-0000-4000-8003-000000000002", "caller": "sample_caller_02", "asset": "ETH", "direction": "short", "called_at": "2026-10-23T09:00:00.000Z", "horizon_hours": 24, "status": "open", "outcome": null, "return_pct": null, "scored_at": null, "text": null }, { "id": "00000000-0000-4000-8003-000000000003", "caller": "sample_caller_03", "asset": "SOL", "direction": "long", "called_at": "2026-10-23T06:00:00.000Z", "horizon_hours": 24, "status": "open", "outcome": null, "return_pct": null, "scored_at": null, "text": null } ], "next_cursor": "eyJ0IjoiMjAyNi0xMC0yM1QwNjowMDowMC4wMDBaIiwiaWQiOiIwMDAwMDAwMC0wMDAwLTQwMDAtODAwMy0wMDAwMDAwMDAwMDMifQ", "as_of": "2026-10-23T12:01:30.000Z", "disclaimer": "Historical figures. Past performance is not a guide to future performance. Information only, not financial advice."}Most-logged coins GET
Assets with the most community trades in the window, with the long share. An asset needs 10 or more traders 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 `calls:read` and the starter plan or above.
One public trade 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. One public trade by id. Cost: 1 unit, also when not found. Needs scope `calls:read` and the pro plan or above.