Live news signal stream (SSE)
get/v1/stream/signals
https://data.decryptr.ai/v1/stream/signals
- API planPro and above
- Scope
stream:read - Costconnecting is free; 1 unit per event delivered, taken before it is sent. 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
Server-sent events of new signals: id (the signal id), event: signal, data (a Signal as JSON). Send Last-Event-ID to resume. The server closes each connection after about 2 minutes with an end event; reconnect and nothing is missed. Pro: 2 connections; Business: 10 (shared with the post stream).
Cost: connecting is free; 1 unit per event delivered, taken before it is sent.
Needs scope stream: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_....
Last-Event-ID?stringResume after this event id.
^[0-9]{1,18}$OK.
response?stringtext/event-streamA stream of server-sent events.
curl -X GET 'https://data.decryptr.ai/v1/stream/signals' \
-H 'Last-Event-ID: 99990'"retry: 3000\n\nid: 99990\nevent: signal\ndata: {\"id\":99990,\"published_at\":\"2026-10-23T10:00:00.000Z\",\"ingested_at\":\"2026-10-23T10:00:00.000Z\",\"channel\":\"publisher\",\"headline\":\"Sample headline 99990\",\"summary\":null,\"source\":{\"name\":\"Sample Publisher\",\"url\":\"https://example.com/sample/99990\"},\"category\":\"market\",\"event\":\"etf\",\"impact\":3,\"sentiment\":\"neutral\",\"assets\":[\"BTC\"],\"tags\":[\"$BTC\"]}\n\n: ping\n\nevent: end\ndata: {\"reason\":\"max_duration\",\"reconnect\":true,\"last_event_id\":\"99990\"}\n"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.
Economic calendar GET
The economic releases Decryptr runs event rooms for (US CPI, FOMC, jobs report, PCE, and token unlocks), soonest first, with forecast, previous and actual as published. Past events go back as far as your plan's history; future events are always included. Schedule and figures from TradingView: keep the attribution line. 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 `calendar:read` and the starter plan or above.