Trending tags
get/v1/trending/tags
https://data.decryptr.ai/v1/trending/tags
- API planStarter and above
- Scope
analytics: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 |
|---|---|---|---|---|
| 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
Tags ranked by Decryptr posts in the last 24 hours or 7 days, 5 or more posters each. Never X.
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 starter plan or above.
AuthorizationBearer <dcr_live_<8 hex>_<43 base64url> or dcr_test_...>Your API key as a Bearer token: Authorization: Bearer dcr_live_....
window?stringLook-back window. Default 24h.
"24h""7d"kind?stringcashtag, chain or keyword.
"cashtag""chain""keyword"limit?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-timewindow*stringThe window asked for.
disclaimer*stringPlain-language notice. Information only, not financial advice.
curl -X GET 'https://data.decryptr.ai/v1/trending/tags?window=24h&kind=cashtag&limit=10'{ "data": [ { "rank": 1, "tag": "$BTC", "kind": "cashtag", "posts": 300, "posters": 90 }, { "rank": 2, "tag": "$ETH", "kind": "cashtag", "posts": 275, "posters": 84 }, { "rank": 3, "tag": "$SOL", "kind": "cashtag", "posts": 250, "posters": 78 } ], "as_of": "2026-10-23T12:37:30.000Z", "window": "24h", "disclaimer": "Crowd and model output, not a recommendation. Information only, not financial advice."}Posts per hour or day for a tag GET
Decryptr posts per hour or day carrying a tag from the app's search index: a cashtag ($BTC), a chain (chain:solana) or a keyword (kw:etf), newest first. Never X. Null where under 5 people posted. 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 starter plan or above.
Trade outcomes per asset GET
How community trades turned out, per asset, for trades logged in the window: trades, scored, right, hit rate, average return and long share. Assets with under 10 traders are left out. Returns are percentages Decryptr computed; prices are not included. 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 developer plan or above.