> ## Documentation Index
> Fetch the complete documentation index at: https://coinstats.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Get News
> Get the list of cryptocurrency news articles with pagination.
**5** credits per request
* page & limit: Control pagination.
* source: Filter by news source.
## OpenAPI
````yaml /api-reference/openapi.json get /v1/news
openapi: 3.0.0
info:
title: CoinStats Public API
description: >-
CoinStats Public API — programmatic access to market data, news, NFTs,
wallets, exchange connections, and user portfolios. Authenticate every
request with the `X-API-KEY` header (or an OAuth Bearer token in the
`Authorization` header). Generate keys at https://openapi.coinstats.app.
version: '1.0'
contact: {}
servers:
- url: https://openapiv1.coinstats.app
security: []
tags:
- name: CoinStats
description: ''
- name: Market Data
description: >-
The Market Data section of the API provides endpoints to access a wide
range of market-related information, including cryptocurrency coins,
ticker data, and fiat currency rates. This category offers comprehensive
data to help users monitor and analyze the cryptocurrency market, track
prices, and gain insights into market trends
- name: News
description: >-
The News section of the API allows you to access news articles and updates
related to cryptocurrencies and the blockchain industry. It provides
valuable information from various sources to keep you informed about the
latest developments
- name: NFTs
description: >-
The NFT section of the API provides endpoints to interact with
Non-Fungible Tokens (NFTs), which are unique digital assets stored on a
blockchain. These endpoints allow you to retrieve information about NFTs,
including collections, assets, trending NFTs, and specific assets
associated with wallet addresses.
- name: Wallet Data
description: >-
The Wallet section of the API provides a comprehensive set of endpoints to
manage and interact with wallets. It enables users to retrieve wallet
balances, monitor syncing status, fetch transaction data, and synchronize
wallet information with the blockchain. By integrating these endpoints
into your application, you can offer robust wallet functionality to your
users.
- name: Exchange Connection
description: >-
The Exchange Connection section of the API provides a comprehensive set of
endpoints to manage and interact with exchanges. It enables users to
retrieve exchange balances, monitor syncing status, fetch transaction
data. By integrating these endpoints into your application, you can offer
robust exchange portfolio tracking functionality to your users.
- name: User Portfolio
description: >-
The Portfolio section of the API provides a comprehensive set of endpoints
to manage and interact with Share Portfolios. It enables users to retrieve
current Portfolio Coins and Transactions.
- name: Usage
description: The Usage section provides account-level API usage data.
- name: Status
description: The Status section provides API availability checks.
paths:
/v1/news:
get:
tags:
- News
summary: Get the list of cryptocurrency news articles with pagination.
operationId: get-news
parameters:
- name: page
required: false
in: query
description: Page number to retrieve for news (1-based indexing)
schema:
example: 1
type: number
- name: limit
required: false
in: query
description: Number of news items to return per page
schema:
example: 20
type: number
- name: from
required: false
in: query
description: Please include the date in ISO 8601 format
schema:
format: date-time
example: '2026-06-19T05:47:13.368Z'
type: string
- name: to
required: false
in: query
description: Please include the date in ISO 8601 format
schema:
format: date-time
example: '2026-06-20T07:47:13.368Z'
type: string
responses:
'200':
description: Get news list
content:
application/json:
schema:
$ref: '#/components/schemas/NewsListResponseDto'
'400':
description: Bad Request
content:
application/json:
example:
statusCode: 400
message: Bad Request
requestId: 11111111-2222-3333-4444-555555555555
path:
'401':
description: Unauthorized
content:
application/json:
example:
statusCode: 401
message: Unauthorized
requestId: 11111111-2222-3333-4444-555555555555
path:
'403':
description: Forbidden
content:
application/json:
example:
statusCode: 403
message: Forbidden
requestId: 11111111-2222-3333-4444-555555555555
path:
'404':
description: Not Found
content:
application/json:
example:
statusCode: 404
message: Not Found
requestId: 11111111-2222-3333-4444-555555555555
path:
'409':
description: Conflict (for some endpoints)
content:
application/json:
example:
statusCode: 409
message: Transactions not synced
requestId: 11111111-2222-3333-4444-555555555555
path:
'429':
description: Too Many Requests
content:
application/json:
example:
statusCode: 429
message: Rate limit exceeded
requestId: 11111111-2222-3333-4444-555555555555
path:
'503':
description: Service Unavailable
content:
application/json:
example:
statusCode: 503
message: Service Unavailable. Please Contact Support
security:
- X-API-KEY: []
components:
schemas:
NewsListResponseDto:
type: object
properties:
result:
description: Array of news feed items
type: array
items:
$ref: '#/components/schemas/NewsFeedResponseItemDto'
required:
- result
NewsFeedResponseItemDto:
type: object
properties:
id:
type: string
description: Unique identifier for the news feed item
example: 376f390df50a1d44cb5593c9bff6faafabed18ee90e0d4d737d3b6d3eea50c80
searchKeyWords:
description: Array of search keywords associated with this news item
example:
- xrp
- XRP
type: array
items:
type: string
feedDate:
type: number
description: Unix timestamp (in milliseconds) when the news was published
example: 1756204736000
source:
type: string
description: Name of the news source/publication
example: CoinGape
title:
type: string
description: Title of the news article
example: Why is XRP Price Down Even After the Ripple Lawsuit End?
isFeatured:
type: boolean
description: Whether this news item is featured/highlighted
example: false
description:
type: string
description: Brief description or summary of the news article
example: coingape.com.
link:
type: string
description: 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:
type: string
description: URL of the news source website
example: https://coingape.com/
imgUrl:
type: string
description: URL of the article image
example: >-
https://coingape.com/wp-content/uploads/2025/08/Why-is-XRP-Price-Down.webp
reactionsCount:
type: object
description: >-
Count of different reaction types on this news item, where keys are
reaction type IDs and values are counts
example:
'2': 13
'3': 18
additionalProperties:
type: number
reactions:
description: Array of reaction identifiers for this news item
example: []
type: array
items:
type: string
shareURL:
type: string
description: 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:
description: Array of cryptocurrency identifiers related to this news
example:
- ripple
- 0xb9ce0dd29c91e02d4620f57a66700fc5e41d6d15_cronos
type: array
items:
type: string
content:
type: boolean
description: Whether the full content of the article is available
example: true
bigImg:
type: boolean
description: Whether this news item should display with a large image format
example: false
coins:
type: array
description: 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
required:
- id
- feedDate
- source
- title
- isFeatured
- link
- sourceLink
- imgUrl
- reactionsCount
- reactions
- shareURL
- relatedCoins
- content
- bigImg
securitySchemes:
X-API-KEY:
type: apiKey
in: header
name: X-API-KEY
description: >-
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.
````