One news signal
get/v1/signals/{id}
https://data.decryptr.ai/v1/signals/{id}
- API planStarter and above
- Scope
signals:read - Cost1 unit, also when not found. 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.
- 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
One news signal by id, with the same fields and rules as the list.
Cost: 1 unit, also when not found.
Needs scope signals: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_....
id*integerSignal id.
1 <= valueOK.
application/json- response
data*A news signal. Publisher stories: headline, publisher, link, times and Decryptr's tags. X stories: the post link and Decryptr's own summary only. Never article text, publisher descriptions or X post text.
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/signals/99990'{ "data": { "id": 99990, "published_at": "2026-10-23T02:00:00.000Z", "ingested_at": "2026-10-23T02:00:00.000Z", "channel": "publisher", "headline": "Sample headline 99990", "summary": null, "source": { "name": "Sample Publisher", "url": "https://example.com/sample/99990" }, "category": "market", "event": "listing", "impact": 4, "sentiment": "bearish", "assets": [ "SOL" ], "tags": [ "$SOL", "kw:sample" ] }, "as_of": "2026-10-23T12:11:30.000Z", "disclaimer": "Headlines belong to their publishers: link to the source for the story. Summaries, tags, sentiment and impact are Decryptr model output, not a recommendation. Information only, not financial advice."}News signal metadata GET
News signals, newest first. Publisher stories: headline, publisher name and link, times, and Decryptr's tags, sentiment, impact and coins; never the article text or the publisher's description. Stories from X: the post link and Decryptr's own summary only; never the post text or the account. Headlines belong to their publishers: show the source and link to it. 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 `signals:read` and the starter plan or above.
How the tagged coins moved after a signal GET
How each coin a story tagged moved after it landed: 5 minutes, 15 minutes, 1 hour, 4 hours and 24 hours, in percent. Never a price. Cost: 2 units, also when not found. Needs scope `signals:read` and the pro plan or above.