Skip to main content
GET
/
news
/
type
/
{type}
Get cryptocurrency news articles based on a specific type.
curl --request GET \
  --url https://openapiv1.coinstats.app/news/type/{type} \
  --header 'X-API-KEY: <api-key>'
[
  {
    "id": "376f390df50a1d44cb5593c9bff6faafabed18ee90e0d4d737d3b6d3eea50c80",
    "searchKeyWords": [
      "xrp",
      "XRP"
    ],
    "feedDate": 1756204736000,
    "source": "CoinGape",
    "title": "Why is XRP Price Down Even After the Ripple Lawsuit End?",
    "isFeatured": false,
    "description": "coingape.com.",
    "link": "https://coingape.com/trending/why-is-xrp-price-down-even-after-the-ripple-lawsuit-end/?utm_medium=referral&utm_source=coinstats",
    "sourceLink": "https://coingape.com/",
    "imgUrl": "https://coingape.com/wp-content/uploads/2025/08/Why-is-XRP-Price-Down.webp",
    "reactionsCount": {
      "2": 13,
      "3": 18
    },
    "reactions": [],
    "shareURL": "https://coinstats.app/news/376f390df50a1d44cb5593c9bff6faafabed18ee90e0d4d737d3b6d3eea50c80_Why-is-XRP-Price-Down-Even-After-the-Ripple-Lawsuit-End",
    "relatedCoins": [
      "ripple",
      "0xb9ce0dd29c91e02d4620f57a66700fc5e41d6d15_cronos"
    ],
    "content": true,
    "bigImg": false,
    "coins": [
      {
        "coinKeyWords": "XRP",
        "coinPercent": -5.11,
        "coinTitleKeyWords": "XRP",
        "coinNameKeyWords": "XRP",
        "coinIdKeyWords": "ripple"
      },
      {
        "coinKeyWords": "XRP",
        "coinPercent": -4.67,
        "coinTitleKeyWords": "XRP",
        "coinNameKeyWords": "XRP",
        "coinIdKeyWords": "0xb9ce0dd29c91e02d4620f57a66700fc5e41d6d15_cronos"
      }
    ]
  }
]
5 credits per request

Authorizations

​
X-API-KEY
string
header
required

API key needed to access the endpoints. Example: 'demo-api-key'

Path Parameters

​
type
enum<string>
required

The type of news to get

Available options:
handpicked,
trending,
latest,
bullish,
bearish

Query Parameters

​
page
number

Page number to retrieve (1-based indexing)

Example:

1

​
limit
number

Number of items to return per page

Example:

20

Response

Get news list by type

​
id
string
required

Unique identifier for the news feed item

Example:

"376f390df50a1d44cb5593c9bff6faafabed18ee90e0d4d737d3b6d3eea50c80"

​
feedDate
number
required

Unix timestamp (in milliseconds) when the news was published

Example:

1756204736000

​
source
string
required

Name of the news source/publication

Example:

"CoinGape"

​
title
string
required

Title of the news article

Example:

"Why is XRP Price Down Even After the Ripple Lawsuit End?"

​
isFeatured
boolean
required

Whether this news item is featured/highlighted

Example:

false

​
link
string
required

Direct link to the full news article

Example:

"https://coingape.com/trending/why-is-xrp-price-down-even-after-the-ripple-lawsuit-end/?utm_medium=referral&utm_source=coinstats"

​
sourceLink
string
required

URL of the news source website

Example:

"https://coingape.com/"

​
imgUrl
string
required

URL of the article image

Example:

"https://coingape.com/wp-content/uploads/2025/08/Why-is-XRP-Price-Down.webp"

​
reactionsCount
object
required

Count of different reaction types on this news item, where keys are reaction type IDs and values are counts

Example:
{ "2": 13, "3": 18 }
​
reactions
string[]
required

Array of reaction identifiers for this news item

Example:
[]
​
shareURL
string
required

Shareable URL for this news item on CoinStats platform

Example:

"https://coinstats.app/news/376f390df50a1d44cb5593c9bff6faafabed18ee90e0d4d737d3b6d3eea50c80_Why-is-XRP-Price-Down-Even-After-the-Ripple-Lawsuit-End"

​
relatedCoins
string[]
required

Array of cryptocurrency identifiers related to this news

Example:
[
  "ripple",
  "0xb9ce0dd29c91e02d4620f57a66700fc5e41d6d15_cronos"
]
​
content
boolean
required

Whether the full content of the article is available

Example:

true

​
bigImg
boolean
required

Whether this news item should display with a large image format

Example:

false

​
searchKeyWords
string[]

Array of search keywords associated with this news item

Example:
["xrp", "XRP"]
​
description
string

Brief description or summary of the news article

Example:

"coingape.com."

​
coins
any[]

Cryptocurrency data associated with this news

Example:
[
  {
    "coinKeyWords": "XRP",
    "coinPercent": -5.11,
    "coinTitleKeyWords": "XRP",
    "coinNameKeyWords": "XRP",
    "coinIdKeyWords": "ripple"
  },
  {
    "coinKeyWords": "XRP",
    "coinPercent": -4.67,
    "coinTitleKeyWords": "XRP",
    "coinNameKeyWords": "XRP",
    "coinIdKeyWords": "0xb9ce0dd29c91e02d4620f57a66700fc5e41d6d15_cronos"
  }
]
⌘I