Skip to main content
GET
/
v3
/
news
/
{id}
News detail
curl --request GET \
  --url https://api.cryptorank.io/v3/news/{id} \
  --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

Path Parameters

​
id
number
required

News id.

Response

​
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