curl --request GET \
--url https://api.coinstats.app/v1/coins \
--header 'X-API-KEY: <api-key>'import requests
url = "https://api.coinstats.app/v1/coins"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api.coinstats.app/v1/coins', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.coinstats.app/v1/coins",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
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"
"net/http"
"io"
)
func main() {
url := "https://api.coinstats.app/v1/coins"
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/coins")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.coinstats.app/v1/coins")
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{
"meta": {
"page": 1,
"limit": 20,
"itemCount": 150,
"pageCount": 8,
"hasPreviousPage": false,
"hasNextPage": true
},
"result": [
{
"id": "ethereum",
"icon": "https://static.coinstats.app/coins/ethereum_32.png",
"name": "Ethereum",
"symbol": "ETH",
"rank": 2,
"price": 2680.45,
"priceBtc": 0.062,
"volume": 8520000000,
"marketCap": 322100000000,
"availableSupply": 120280000,
"totalSupply": 120280000,
"fullyDilutedValuation": 322100000000,
"priceChange1h": -0.25,
"priceChange1d": 1.85,
"priceChange1w": 3.42,
"priceChange1m": 7.21,
"websiteUrl": "https://ethereum.org",
"redditUrl": "https://reddit.com/r/ethereum",
"twitterUrl": "https://twitter.com/ethereum",
"contractAddress": null,
"contractAddresses": [],
"decimals": 18,
"explorers": [
"https://etherscan.io"
],
"liquidityScore": 88.7,
"volatilityScore": 38.9,
"marketCapScore": 92.1,
"riskScore": 18.5,
"avgChange": 2.14
}
]
}{
"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"
}Get Coins
Get comprehensive data about all cryptocurrencies
curl --request GET \
--url https://api.coinstats.app/v1/coins \
--header 'X-API-KEY: <api-key>'import requests
url = "https://api.coinstats.app/v1/coins"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api.coinstats.app/v1/coins', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.coinstats.app/v1/coins",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
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"
"net/http"
"io"
)
func main() {
url := "https://api.coinstats.app/v1/coins"
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/coins")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.coinstats.app/v1/coins")
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{
"meta": {
"page": 1,
"limit": 20,
"itemCount": 150,
"pageCount": 8,
"hasPreviousPage": false,
"hasNextPage": true
},
"result": [
{
"id": "ethereum",
"icon": "https://static.coinstats.app/coins/ethereum_32.png",
"name": "Ethereum",
"symbol": "ETH",
"rank": 2,
"price": 2680.45,
"priceBtc": 0.062,
"volume": 8520000000,
"marketCap": 322100000000,
"availableSupply": 120280000,
"totalSupply": 120280000,
"fullyDilutedValuation": 322100000000,
"priceChange1h": -0.25,
"priceChange1d": 1.85,
"priceChange1w": 3.42,
"priceChange1m": 7.21,
"websiteUrl": "https://ethereum.org",
"redditUrl": "https://reddit.com/r/ethereum",
"twitterUrl": "https://twitter.com/ethereum",
"contractAddress": null,
"contractAddresses": [],
"decimals": 18,
"explorers": [
"https://etherscan.io"
],
"liquidityScore": 88.7,
"volatilityScore": 38.9,
"marketCapScore": 92.1,
"riskScore": 18.5,
"avgChange": 2.14
}
]
}{
"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"
}You will get
You will get
- Price, market cap, and volume
- Price changes (1h, 24h, 7d, 1m)
- Supply information
- Trading metrics
- Social links and metadata
Optional
Optional
- currency: Display currency (defaults to USD).
- page & limit: Control pagination.
- includeRiskScore: When
true, response includes the risk score field. - categories: Comma-separated category filters.
- blockchains: Comma-separated blockchain filters.
- sortBy / sortDir: Sort the result set.
Authorizations
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.
Query Parameters
Page number to retrieve (1-based indexing)
1
Number of items to return per page
20
Filter coins by up to 100 specific coin IDs. Use comma-separated values to specify multiple coins. Each coin ID should be the unique identifier for the cryptocurrency.
"bitcoin,ethereum,solana"
The currency to display coin prices and market data in.
"USD"
Search for coins by their name. Supports partial matching - you can search for "bit" to find "Bitcoin" and other coins containing that substring.
"bitcoin"
Filter coins by their ticker symbol. Use the standard trading symbol for the cryptocurrency (e.g., BTC for Bitcoin, ETH for Ethereum).
"BTC"
Filter coins by smart contract addresses. Use comma-separated values to specify multiple addresses. Matching is case-insensitive.
"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48,0xdac17f958d2ee523a2206206994597c13d831ec7"
Filter coins by blockchain networks. Use comma-separated values to specify multiple blockchains. Common values include ethereum, solana, binance-smart-chain, polygon, avalanche.
"ethereum,solana,binance-smart-chain"
Include risk score data in the response. Set to "true" to include risk assessment metrics, or "false" to exclude them.
"true"
Filter coins by categories. Use comma-separated values to specify multiple categories. Common categories include defi, memecoins, gaming, nft, metaverse, layer-1, layer-2.
"defi,memecoins,gaming"
Field to sort results by.
rank, marketCap, price, volume, priceChange1h, priceChange1d, priceChange7d, priceChange1m, name, symbol "marketCap"
Sort direction for the results. Use "asc" for ascending order or "desc" for descending order.
asc, desc "desc"
Filter coins with market capitalization greater than the specified value (in USD). Example: 1000000000 for coins with market cap above $1 billion.
"1000000000"
Filter coins with market capitalization equal to the specified value (in USD). Exact matches are rare due to constant price fluctuations.
"500000000"
Filter coins with market capitalization less than the specified value (in USD). Example: 100000000 for coins with market cap below $100 million.
"100000000"
Filter coins with fully diluted valuation greater than the specified value (in USD). FDV represents the theoretical market cap if all tokens were in circulation.
"2000000000"
Filter coins with fully diluted valuation equal to the specified value (in USD). FDV = total supply × current price.
"1500000000"
Filter coins with fully diluted valuation less than the specified value (in USD). Useful for finding smaller cap projects with growth potential.
"500000000"
Filter coins with 24-hour trading volume greater than the specified value (in USD). Higher volume indicates more liquidity and trading activity.
"10000000"
Filter coins with 24-hour trading volume equal to the specified value (in USD). Exact matches are uncommon due to constant trading activity.
"5000000"
Filter coins with 24-hour trading volume less than the specified value (in USD). Useful for finding less traded or emerging coins.
"1000000"
Filter coins with 1-hour price change greater than the specified percentage. Example: 5 for coins with more than 5% gain in the last hour.
"5"
Filter coins with 1-hour price change equal to the specified percentage. Useful for finding stable coins in short timeframes.
"0"
Filter coins with 1-hour price change less than the specified percentage. Example: -2 for coins declining more than 2% in the last hour.
"-2"
Filter coins with 24-hour price change greater than the specified percentage. Example: 10 for coins with more than 10% daily gain.
"10"
Filter coins with 24-hour price change equal to the specified percentage. Useful for finding stable coins over a day.
"0"
Filter coins with 24-hour price change less than the specified percentage. Example: -5 for coins declining more than 5% today.
"-5"
Filter coins with 7-day price change greater than the specified percentage. Example: 20 for coins with more than 20% weekly gain.
"20"
Filter coins with 7-day price change equal to the specified percentage. Useful for finding coins with stable weekly performance.
"0"
Filter coins with 7-day price change less than the specified percentage. Example: -10 for coins declining more than 10% this week.
"-10"
Filter coins with 1-month price change greater than the specified percentage. Example: 30 for coins with more than 30% monthly gain.
"30"
Filter coins with 1-month price change equal to the specified percentage. Useful for finding coins with stable monthly performance.
"0"
Filter coins with 1-month price change less than the specified percentage. Example: -20 for coins declining more than 20% this month.
"-20"
Filter coins with circulating supply greater than the specified amount. This represents tokens currently available for trading in the market.
"1000000"
Filter coins with circulating supply equal to the specified amount. Example: 21000000 for Bitcoin's maximum supply.
"21000000"
Filter coins with circulating supply less than the specified amount. Useful for finding scarce or limited supply tokens.
"100000"
Filter coins with total supply greater than the specified amount. Total supply includes all minted tokens, including locked and vested ones.
"10000000"
Filter coins with total supply equal to the specified amount. Useful for finding tokens with specific supply characteristics.
"1000000000"
Filter coins with total supply less than the specified amount. Great for finding ultra-scarce tokens with limited total supply.
"500000"
Filter coins with market cap rank greater than the specified number. Example: 100 to exclude top 100 coins and find smaller cap projects.
"100"
Filter coins with market cap rank equal to the specified number. Example: 10 to find the 10th largest cryptocurrency by market cap.
"10"
Filter coins with market cap rank less than the specified number. Example: 50 to show only top 50 cryptocurrencies.
"50"
Filter coins with current price greater than the specified value (in the selected currency). Example: 100 for coins priced above $100.
"100"
Filter coins with current price equal to the specified value. Useful for finding stablecoins or coins at specific price points.
"1"
Filter coins with current price less than the specified value. Example: 0.01 for coins under 1 cent, often called "penny coins".
"0.01"
Filter coins with risk score greater than the specified value (0-100 scale). Higher scores indicate higher risk. Only available when includeRiskScore=true.
0 <= x <= 100"70"
Filter coins with risk score equal to the specified value (0-100 scale). Useful for finding coins with specific risk profiles. Only available when includeRiskScore=true.
0 <= x <= 100"50"
Filter coins with risk score less than the specified value (0-100 scale). Lower scores indicate lower risk investments. Only available when includeRiskScore=true.
0 <= x <= 100"30"
Response
Get coins list
Pagination metadata including page info and totals
Show child attributes
Show child attributes
{ "page": 1, "limit": 20, "itemCount": 150, "pageCount": 8, "hasPreviousPage": false, "hasNextPage": true }
Array of coin data items for the current page
Show child attributes
Show child attributes
[ { "id": "ethereum", "icon": "https://static.coinstats.app/coins/ethereum_32.png", "name": "Ethereum", "symbol": "ETH", "rank": 2, "price": 2680.45, "priceBtc": 0.062, "volume": 8520000000, "marketCap": 322100000000, "availableSupply": 120280000, "totalSupply": 120280000, "fullyDilutedValuation": 322100000000, "priceChange1h": -0.25, "priceChange1d": 1.85, "priceChange1w": 3.42, "priceChange1m": 7.21, "websiteUrl": "https://ethereum.org", "redditUrl": "https://reddit.com/r/ethereum", "twitterUrl": "https://twitter.com/ethereum", "contractAddress": null, "contractAddresses": [], "decimals": 18, "explorers": ["https://etherscan.io"], "liquidityScore": 88.7, "volatilityScore": 38.9, "marketCapScore": 92.1, "riskScore": 18.5, "avgChange": 2.14 } ]
Was this page helpful?