GET
/
coins
cURL
curl --request GET \
  --url https://openapiv1.coinstats.app/coins \
  --header 'X-API-KEY: <api-key>'
{
  "meta": {
    "page": 1,
    "limit": 40,
    "itemCount": 100,
    "pageCount": 3,
    "hasPreviousPage": false,
    "hasNextPage": true
  },
  "result": [
    {
      "id": "<string>",
      "icon": "<string>",
      "name": "<string>",
      "symbol": "<string>",
      "rank": 123,
      "price": 123,
      "priceBtc": 123,
      "volume": 123,
      "marketCap": 123,
      "availableSupply": 123,
      "totalSupply": 123,
      "fullyDilutedValuation": 123,
      "priceChange1h": 123,
      "priceChange1d": 123,
      "priceChange1w": 123,
      "websiteUrl": "<string>",
      "redditUrl": "<string>",
      "twitterUrl": "<string>",
      "contractAddress": "<string>",
      "contractAddresses": [
        {
          "blockchain": "<string>",
          "contractAddress": "<string>"
        }
      ],
      "decimals": 123,
      "explorers": [
        "<string>"
      ],
      "liquidityScore": 123,
      "volatilityScore": 123,
      "marketCapScore": 123,
      "riskScore": 123,
      "avgChange": 123
    }
  ]
}
2 credits per request
Get comprehensive data about all cryptocurrencies:
  • Price, market cap, and volume
  • Price changes (1h, 24h, 7d)
  • Supply information
  • Trading metrics
  • Social links and metadata
Optional Parameters:
  • currency: Price display currency (default: USD)
  • limit & skip: Pagination controls
  • includeRiskScore: Add risk analysis data
  • categories: Filter by coin categories
  • blockchains: Filter by blockchain networks
Sorting Options:
  • sortBy: rank, price, volume, etc.
  • sortDir: asc or desc

Authorizations

X-API-KEY
string
header
required

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

Query Parameters

page
number
Example:

1

limit
number
Example:

20

currency
string
Example:

"USD"

name
string

Search coins by name

Example:

"bitcoin"

symbol
string

Get coins by symbol

Example:

"BTC"

blockchains
string

Seperate by commas ( , ) eg. ethereum,solana

includeRiskScore
string

true or false. Default - false

categories
string

Seperate by commas ( , ) eg. memecoins,sports

sortBy
string

One of filter fields

Example:

"rank"

sortDir
string

One of asc, desc

Example:

"asc"

marketCap~greaterThan
number

Marketcap Greater Than

marketCap~equals
number

Marketcap Equals

marketCap~lessThan
number

Marketcap Less Than

fullyDilutedValuation~greaterThan
number

Fully Diluted Valuation Greater Than

fullyDilutedValuation~equals
number

Fully Diluted Valuation Equals

fullyDilutedValuation~lessThan
number

Fully Diluted Valuation Less Than

volume~greaterThan
number

Volume Greater Than

volume~equals
number

Volume Equals

volume~lessThan
number

Volume Less Than

priceChange1h~greaterThan
number

Price Change 1h Greater Than

priceChange1h~equals
number

Price Change 1h Equals

priceChange1h~lessThan
number

Price Change 1h Less Than

priceChange1d~greaterThan
number

Price Change 1d Greater Than

priceChange1d~equals
number

Price Change 1d Equals

priceChange1d~lessThan
number

Price Change 1d Less Than

priceChange7d~greaterThan
number

Price Change 7d Greater Than

priceChange7d~equals
number

Price Change 7d Equals

priceChange7d~lessThan
number

Price Change 7d Less Than

availableSupply~greaterThan
number

Available Supply Greater Than

availableSupply~equals
number

Available Supply Equals

availableSupply~lessThan
number

Available Supply Less Than

totalSupply~greaterThan
number

Total Supply Greater Than

totalSupply~equals
number

Total Supply Equals

totalSupply~lessThan
number

Total Supply Less Than

rank~greaterThan
number

Rank Greater Than

rank~equals
number

Rank Equals

rank~lessThan
number

Rank Less Than

price~greaterThan
number

Price Greater Than

price~equals
number

Price Equals

price~lessThan
number

Price Less Than

riskScore~greaterThan
number

Risk Score Greater Than (Only if includeRiskScore=true)

riskScore~equals
number

RiskScore Equals (Only if includeRiskScore=true)

riskScore~lessThan
number

RiskScore Less Than (Only if includeRiskScore=true)

Response

200
application/json

Get coins list

The response is of type object.