Skip to main content
GET
/
v3
/
news
/
feed
News feed
curl --request GET \
  --url https://api.cryptorank.io/v3/news/feed \
  --header 'X-Api-Key: <api-key>'
[
  {
    "id": 1234567,
    "title": "Bitcoin breaks new all-time high",
    "heroText": {},
    "mainText": {},
    "source": "CoinDesk",
    "sourceUrl": "https://www.coindesk.com/markets/2024/01/01/btc-ath",
    "previewImage": "https://img.cryptorank.io/news/abc.jpg",
    "publishedAt": "2024-01-01T12:34:56.000Z",
    "language": "en",
    "tags": [
      {
        "key": "defi",
        "name": "DeFi"
      }
    ],
    "assignedTokens": [
      {
        "id": 1,
        "symbol": "BTC"
      }
    ],
    "assignedFunds": [
      {
        "id": 12,
        "name": "Pantera Capital"
      }
    ],
    "hasMainText": true
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.cryptorank.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-Api-Key
string
header
required

Query Parameters

​
limit
number
default:20
Required range: 1 <= x <= 100
​
cursor
string

Opaque pagination cursor returned by the previous response as meta.nextCursor. Pass it back unchanged to fetch the next page.

​
language
enum<string>

Filter by article language. Omit to return all languages.

Available options:
en,
ru,
es,
zh,
tr,
vi,
pt,
ko
​
currency
number

Filter by currency id — only articles assigned to that currency.

​
fund
number

Filter by fund id — only articles assigned to that fund.

​
tag
string

Filter by tag slug (e.g. defi, markets).

​
from
string

Return articles published on or after this moment (ISO 8601 or Unix timestamp in seconds/milliseconds).

​
to
string

Return articles published on or before this moment (ISO 8601 or Unix timestamp in seconds/milliseconds). Bare dates (YYYY-MM-DD) are treated as end-of-day UTC so the named day is included.

Response

200 - application/json
​
id
number
required
Example:

1234567

​
title
string
required
Example:

"Bitcoin breaks new all-time high"

​
heroText
object
required

Short preview / lead text. Null when the source did not provide one.

​
mainText
object
required

Full article body (HTML). Always null in GET /news/feed — use GET /news/{id} to fetch. On the detail endpoint, null when the article has no body (headline-only item).

​
source
string
required

Source name.

Example:

"CoinDesk"

​
sourceUrl
object
required

Link to the original article. Null when the source URL is unavailable.

Example:

"https://www.coindesk.com/markets/2024/01/01/btc-ath"

​
previewImage
object
required

Preview image URL. Null when the article has no image.

Example:

"https://img.cryptorank.io/news/abc.jpg"

​
publishedAt
string
required

Publication timestamp (ISO 8601).

Example:

"2024-01-01T12:34:56.000Z"

​
language
enum<string> | null
required

Article language. Null when the source did not declare one.

Available options:
en,
ru,
es,
zh,
tr,
vi,
pt,
ko
Example:

"en"

​
tags
object[]
required

Tags attached to the article. Each item has a stable key (slug, usable as the tag filter) and a human-readable name.

​
assignedTokens
object[]
required

Currencies referenced by the article.

​
assignedFunds
object[]
required

Funds referenced by the article.

​
hasMainText
boolean

Feed-only. True when the full article body is available — mainText will be populated by GET /news/{id}. False for headline-only items. Absent on GET /news/{id} (use mainText directly).

Example:

true