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
Sentiment

News signals per day by sentiment

get/v1/sentiment/{asset}/news

https://data.decryptr.ai/v1/sentiment/{asset}/news

  • 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 about one asset per day, newest first, counted by Decryptr's sentiment tag, with the average impact score.

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

Path Parameters

asset*string

Asset symbol, letters and digits, case-insensitive.

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

Query Parameters

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/sentiment/BTC/news?since=2026-10-20T00%3A00%3A00Z&until=2026-10-23T12%3A00%3A00Z&cursor=eyJ0IjoiMjAyNi0xMC0yM1QxMDowMDowMC4wMDBaIn0&limit=10'
Example Response
{  "data": [    {      "asset": "BTC",      "day": "2026-10-23",      "signals": 12,      "bullish": 5,      "bearish": 3,      "neutral": 4,      "avg_impact": 2.1    },    {      "asset": "BTC",      "day": "2026-10-22",      "signals": 13,      "bullish": 5,      "bearish": 4,      "neutral": 5,      "avg_impact": 2.1    },    {      "asset": "BTC",      "day": "2026-10-21",      "signals": 14,      "bullish": 5,      "bearish": 3,      "neutral": 6,      "avg_impact": 2.1    }  ],  "next_cursor": "eyJ0IjoiMjAyNi0xMC0yMVQwMDowMDowMFoifQ",  "as_of": "2026-10-23T12:13: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."}