Don't invest unless you're prepared to lose all the money you invest. This is a high-risk investment and you should not expect to be protected if something goes wrong. Take 2 mins to learn more.

DecryptrDevelopers
News and events

News signal metadata

get/v1/signals

https://data.decryptr.ai/v1/signals

  • API planStarter and above
  • Scopesignals: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

PlanUnits a monthPer secondPer minuteMost per request
Starter50,00056025
Pro300,0001530050
Business1,500,00040900100
EnterpriseAgreedAgreedAgreedAgreed

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

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.

Authorization

headerAuthorizationBearer <dcr_live_<8 hex>_<43 base64url> or dcr_test_...>

Your API key as a Bearer token: Authorization: Bearer dcr_live_....

Query Parameters

asset?string

Asset symbol, letters and digits, case-insensitive (BTC, ETH, SOL).

Match^[A-Za-z0-9]{1,15}$
category?string

Decryptr category.

Value in"coin""market""whale"
event?string

Decryptr event tag, lower case.

Match^[a-z_]{1,30}$
min_impact?integer

Only signals with at least this impact (0 to 5).

Range0 <= value <= 5
channel?string

publisher or x.

Value in"publisher""x"
sentiment?string

Decryptr's sentiment tag: bullish, bearish or neutral.

Value in"bullish""bearish""neutral"
since?string

Only 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.

Formatdate-time
until?string

Only items at or before this time (ISO 8601 with offset). Defaults to now; on Developer it is capped 60 minutes before now.

Formatdate-time
cursor?string

next_cursor from the previous page, passed back as it is. Opaque: do not build or change it.

Lengthlength <= 300
limit?integer

Items 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.

Range1 <= value <= 100

Response Body

OK.

application/json
  1. response
data*array<>
as_of*string

When the response was made.

Formatdate-time
next_cursor*|

Pass as cursor for the next page. null when this is the last page.

disclaimer*string

Plain-language notice. Information only, not financial advice.

curl -X GET 'https://data.decryptr.ai/v1/signals?asset=BTC&category=market&event=listing&min_impact=3&channel=publisher&sentiment=bullish&since=2026-10-20T00%3A00%3A00Z&until=2026-10-23T12%3A00%3A00Z&cursor=eyJ0IjoiMjAyNi0xMC0yM1QxMDowMDowMC4wMDBaIn0&limit=10'
Example Response
{  "data": [    {      "id": 100000,      "published_at": "2026-10-23T12:00:00.000Z",      "ingested_at": "2026-10-23T12:00:00.000Z",      "channel": "publisher",      "headline": "Sample headline 100000",      "summary": null,      "source": {        "name": "Sample Publisher",        "url": "https://example.com/sample/100000"      },      "category": "coin",      "event": "listing",      "impact": 0,      "sentiment": "bullish",      "assets": [        "BTC"      ],      "tags": [        "$BTC",        "kw:sample"      ]    },    {      "id": 99999,      "published_at": "2026-10-23T11:00:00.000Z",      "ingested_at": "2026-10-23T11:00:00.000Z",      "channel": "x",      "headline": null,      "summary": "Decryptr summary of sample post 99999.",      "source": {        "name": "X",        "url": "https://x.com/sample/status/99999"      },      "category": "market",      "event": "hack",      "impact": 1,      "sentiment": "bearish",      "assets": [        "ETH"      ],      "tags": [        "$ETH",        "kw:sample"      ]    },    {      "id": 99998,      "published_at": "2026-10-23T10:00:00.000Z",      "ingested_at": "2026-10-23T10:00:00.000Z",      "channel": "publisher",      "headline": "Sample headline 99998",      "summary": null,      "source": {        "name": "Sample Publisher",        "url": "https://example.com/sample/99998"      },      "category": "whale",      "event": "etf",      "impact": 2,      "sentiment": "neutral",      "assets": [        "SOL"      ],      "tags": [        "$SOL",        "kw:sample"      ]    }  ],  "next_cursor": "eyJpZCI6OTk5OTh9",  "as_of": "2026-10-23T12:10: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."}