Several traders by id
get/v1/traders/batch
https://data.decryptr.ai/v1/traders/batch
- API planPro and above
- Scope
traders:read - Cost3 units 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 |
|---|---|---|---|---|
| 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. Several traders by pseudonymous id, with the ids not found listed in missing.
Cost: 3 units per id asked for, found or not.
Needs scope traders: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_....
ids*stringComma-separated trader ids, no repeats, within your plan's limit.
length <= 4000OK.
application/json- response
data*array<>as_of*stringWhen the response was made.
date-timemissing*array<string>Ids asked for that are not listed. Still charged.
disclaimer*stringPlain-language notice. Information only, not financial advice.
curl -X GET 'https://data.decryptr.ai/v1/traders/batch?ids=trd_000000000000000000000001%2Ctrd_000000000000000000000002'{ "data": [ { "id": "trd_000000000000000000000001", "handle": "sample_trader_1", "display_name": "Sample Trader 1", "verification": { "wallet": false, "exchange": true, "prop_certificates": 1 }, "performance": null, "calls": { "sealed": 5, "scored": 4, "right": 2 }, "levels": { "avg_score": 50, "rounds": 10 }, "listed_since": "2026-10-23T12:00:00.000Z" }, { "id": "trd_000000000000000000000002", "handle": "sample_trader_2", "display_name": "Sample Trader 2", "verification": { "wallet": true, "exchange": false, "prop_certificates": 0 }, "performance": { "roi_30d_pct": 7, "roi_all_pct": 3, "win_rate_pct": 36, "trade_count": 13, "method": "linked_modified_dietz", "updated_at": "2026-10-23T06:00:00.000Z" }, "calls": { "sealed": 6, "scored": 5, "right": 2 }, "levels": { "avg_score": 51, "rounds": 11 }, "listed_since": "2026-10-22T12:00:00.000Z" } ], "missing": [], "as_of": "2026-10-23T12:06:30.000Z", "disclaimer": "Historical figures. Past performance is not a guide to future performance. Information only, not financial advice."}Verified traders who share their record 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. Verified traders who switched on Share my record through the API: verification, 30-day and all-time return on a verified wallet, win rate, trades and Levels, newest listing first. Cost: 3 units per item returned, at least one item's worth. The request first reserves limit x 3 units (and is refused with 429 if that many are not available), then pays only for what came back. Needs scope `traders:read` and the pro plan or above.
One verified trader 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 trader by pseudonymous id. Cost: 3 units, also when not found. Needs scope `traders:read` and the pro plan or above.