Skip to main content
GET
/
v1
/
news
/
type
/
{type}
cURL
curl --request GET \
  --url 'https://api.coinstats.app/v1/news/type/handpicked' \
  --header 'X-API-KEY: <api-key>'
import requests

url = "https://api.coinstats.app/v1/news/type/handpicked"

headers = {"X-API-KEY": "<api-key>"}

response = requests.request("GET", url, headers=headers)

print(response.json())
const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://api.coinstats.app/v1/news/type/handpicked', options)
.then((response) => response.json())
.then((response) => console.log(response))
.catch((err) => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.coinstats.app/v1/news/type/handpicked",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-KEY: <api-key>"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

import (
"fmt"
"io"
"net/http"
)

func main() {

url := "https://api.coinstats.app/v1/news/type/handpicked"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("X-API-KEY", "<api-key>")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))
}
HttpResponse<String> response = Unirest.get("https://api.coinstats.app/v1/news/type/handpicked")
.header("X-API-KEY", "<api-key>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.coinstats.app/v1/news/type/{type}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body
[
  {
    "id": "376f390df50a1d44cb5593c9bff6faafabed18ee90e0d4d737d3b6d3eea50c80",
    "feedDate": 1756204736000,
    "source": "CoinGape",
    "title": "Why is XRP Price Down Even After the Ripple Lawsuit End?",
    "isFeatured": false,
    "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,
    "searchKeyWords": [
      "xrp",
      "XRP"
    ],
    "description": "coingape.com.",
    "coins": [
      {
        "coinKeyWords": "XRP",
        "coinPercent": -5.11,
        "coinTitleKeyWords": "XRP",
        "coinNameKeyWords": "XRP",
        "coinIdKeyWords": "ripple"
      },
      {
        "coinKeyWords": "XRP",
        "coinPercent": -4.67,
        "coinTitleKeyWords": "XRP",
        "coinNameKeyWords": "XRP",
        "coinIdKeyWords": "0xb9ce0dd29c91e02d4620f57a66700fc5e41d6d15_cronos"
      }
    ]
  }
]
{
"statusCode": 400,
"message": "Bad Request",
"requestId": "11111111-2222-3333-4444-555555555555",
"path": "<requested-endpoint>"
}
{
"statusCode": 401,
"message": "Unauthorized",
"requestId": "11111111-2222-3333-4444-555555555555",
"path": "<requested-endpoint>"
}
{
"statusCode": 403,
"message": "Forbidden",
"requestId": "11111111-2222-3333-4444-555555555555",
"path": "<requested-endpoint>"
}
{
"statusCode": 404,
"message": "Not Found",
"requestId": "11111111-2222-3333-4444-555555555555",
"path": "<requested-endpoint>"
}
{
"statusCode": 409,
"message": "Transactions not synced",
"requestId": "11111111-2222-3333-4444-555555555555",
"path": "<requested-endpoint>"
}
{
"statusCode": 429,
"message": "Rate limit exceeded",
"requestId": "11111111-2222-3333-4444-555555555555",
"path": "<requested-endpoint>"
}
{
"statusCode": 503,
"message": "Service Unavailable. Please Contact Support"
}
5 credits per request

  • type: Path parameter. Must be a supported news type (see GET /news/sources for the supported set).
  • page & limit: Control pagination.

Authorizations

X-API-KEY
string
header
required

API key required to access the endpoints. Generate one from your dashboard at https://openapi.coinstats.app and pass it in the X-API-KEY request header. Never expose your key in client-side code.

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?"

Whether this news item is featured/highlighted

Example:

false

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"

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"

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
array

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"
}
]