> ## 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 Ticker Markets
> Returns a list of tickers for a specific cryptocurrency across multiple exchanges.
**3** credits per request
* coinId: Coin identifier (the markets are returned for this coin).
* limit & skip: Control pagination.
## OpenAPI
````yaml /api-reference/openapi.json get /v1/tickers/markets
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/tickers/markets:
get:
tags:
- Market Data
summary: >-
Returns a list of tickers for a specific cryptocurrency across multiple
exchanges.
operationId: get-ticker-markets
parameters:
- name: page
required: false
in: query
description: Page number to retrieve (1-based indexing)
schema:
example: 1
type: number
- name: limit
required: false
in: query
description: Number of items to return per page
schema:
example: 20
type: number
- name: exchange
required: false
in: query
description: Filter tickers by exchange name (case-insensitive exact match)
schema:
example: Binance
type: string
- name: fromCoin
required: false
in: query
description: Filter by base currency symbol of the trading pair
schema:
example: BTC
type: string
- name: toCoin
required: false
in: query
description: Filter by quote currency symbol of the trading pair
schema:
example: USDT
type: string
- name: coinId
required: false
in: query
description: Filter by unique coin identifier (e.g., "bitcoin" for BTC)
schema:
example: bitcoin
type: string
- name: onlyVerified
required: false
in: query
description: >-
When true, returns only verified tickers with recent updates and no
fake volume flags
schema:
example: false
type: boolean
responses:
'200':
description: Get ticker market list
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/TickerMarketListResponseDto'
'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:
TickerMarketListResponseDto:
type: object
properties:
meta:
description: Pagination metadata including total count, page number, and limit
example:
page: 1
limit: 20
itemCount: 57072
pageCount: 2854
hasPreviousPage: false
hasNextPage: true
allOf:
- $ref: '#/components/schemas/PageMetaDto'
result:
description: Array of ticker market data for trading pairs
example:
_created_at: '2023-04-13T07:34:24.442Z'
_updated_at: '2025-08-27T10:56:44.779Z'
exchange: BinanceFutures
from: BTC
to: USD
pair: BTC/USD
price: 111014.4
pairPrice: 111014.4
volume: 1967687277427.2
pairVolume: 17724613
type: array
items:
$ref: '#/components/schemas/TickerMarketItemDto'
required:
- meta
- result
PageMetaDto:
type: object
properties:
page:
type: number
description: Current page number (1-based)
example: 2
minimum: 1
limit:
type: number
description: Number of items per page
example: 20
minimum: 1
maximum: 1000
itemCount:
type: number
description: Total number of items across all pages
example: 150
minimum: 0
pageCount:
type: number
description: Total number of pages available
example: 8
minimum: 0
hasPreviousPage:
type: boolean
description: Whether there is a previous page available
example: true
hasNextPage:
type: boolean
description: Whether there is a next page available
example: true
required:
- page
- limit
- itemCount
- pageCount
- hasPreviousPage
- hasNextPage
TickerMarketItemDto:
type: object
properties:
price:
type: number
description: The price in USD for the trading pair
example: 50000.25
_created_at:
format: date-time
type: string
description: Timestamp when this ticker was first recorded
example: '2024-01-01T00:00:00.000Z'
_updated_at:
format: date-time
type: string
description: Timestamp of the last update for this ticker
example: '2024-01-01T12:30:00.000Z'
exchange:
type: string
description: Name of the exchange where this trading pair is listed
example: Binance
pair:
type: string
description: Trading pair symbol in format BASE/QUOTE
example: BTC/USDT
from:
type: string
description: Base currency of the trading pair
example: BTC
to:
type: string
description: Quote currency of the trading pair
example: USDT
pairPrice:
type: number
description: Price in the original trading pair (not converted to USD)
example: 49985.5
pairVolume:
type: number
description: Trading volume in the original trading pair currency
example: 1250.75
volume:
type: number
description: Trading volume converted to USD
example: 62537500
required:
- price
- _created_at
- _updated_at
- exchange
- pair
- from
- to
- pairPrice
- pairVolume
- volume
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.
````