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

url = "https://api.coinstats.app/v1/coins/bitcoin"

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/coins/bitcoin', 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/coins/bitcoin",
  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/coins/bitcoin"

	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/bitcoin")
  .header("X-API-KEY", "<api-key>")
  .asString();
require 'uri'
require 'net/http'

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

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": "bitcoin",
  "icon": "https://static.coinstats.app/coins/1650455588819.png",
  "name": "Bitcoin",
  "symbol": "BTC",
  "rank": 1,
  "price": 43250.75,
  "priceBtc": 1,
  "volume": 15420000000,
  "marketCap": 847350000000,
  "availableSupply": 19600000,
  "totalSupply": 21000000,
  "fullyDilutedValuation": 907500000000,
  "priceChange1h": 0.75,
  "priceChange1d": 2.15,
  "priceChange1w": -1.42,
  "priceChange1m": 4.25,
  "websiteUrl": "https://bitcoin.org",
  "redditUrl": "https://reddit.com/r/bitcoin",
  "twitterUrl": "https://twitter.com/bitcoin",
  "explorers": [
    "https://blockstream.info"
  ],
  "slug": "bitcoin",
  "contractAddress": "0xa0b86a33e6776e2e09e384b0c92fceaade8fa82f",
  "contractAddresses": [
    {
      "blockchain": "ethereum",
      "contractAddress": "0xa0b86a33e6776e2e09e384b0c92fceaade8fa82f"
    }
  ],
  "decimals": 18,
  "liquidityScore": 85.5,
  "volatilityScore": 42.3,
  "marketCapScore": 95.8,
  "riskScore": 25.7,
  "avgChange": 1.25,
  "isStable": true,
  "color": "FF9500",
  "allTimeHigh": 126080,
  "allTimeLow": 67.81
}
{
  "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"
}
1 credit per request

  • coinId: Path parameter. Unique coin identifier (e.g., bitcoin).
  • currency: Display currency (defaults to USD).

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

coinId
string
default:bitcoin
required

The identifier of coin, which you received from /coins call response.

Query Parameters

currency
string
default:USD

The currency to display coin prices and market data in.

Example:

"USD"

Response

Get Coin with global avg prices

id
string
required

Unique identifier for the cryptocurrency

Example:

"bitcoin"

icon
string
required

URL to the cryptocurrency icon/logo

Example:

"https://static.coinstats.app/coins/1650455588819.png"

name
string
required

Full name of the cryptocurrency

Example:

"Bitcoin"

symbol
string
required

Trading symbol/ticker of the cryptocurrency

Example:

"BTC"

rank
number
required

Market capitalization rank of the cryptocurrency

Example:

1

price
number
required

Current price of the cryptocurrency in USD

Example:

43250.75

priceBtc
number
required

Current price of the cryptocurrency in BTC

Example:

1

volume
number
required

24-hour trading volume in USD

Example:

15420000000

marketCap
number
required

Market capitalization in USD

Example:

847350000000

availableSupply
number
required

Number of coins currently in circulation

Example:

19600000

totalSupply
number
required

Total supply of the cryptocurrency

Example:

21000000

fullyDilutedValuation
number
required

Fully diluted market valuation

Example:

907500000000

priceChange1h
number
required

Percentage price change in the last 1 hour

Example:

0.75

priceChange1d
number
required

Percentage price change in the last 24 hours

Example:

2.15

priceChange1w
number
required

Percentage price change in the last 7 days

Example:

-1.42

priceChange1m
number
required

Percentage price change in the last 1 month

Example:

4.25

websiteUrl
string
required

Official website URL of the cryptocurrency project

Example:

"https://bitcoin.org"

redditUrl
string
required

Reddit community URL for the cryptocurrency

Example:

"https://reddit.com/r/bitcoin"

twitterUrl
string
required

Official Twitter account URL

Example:

"https://twitter.com/bitcoin"

explorers
string[]
required

Array of blockchain explorer URLs

Example:
["https://blockstream.info"]
slug
string
required

URL-friendly identifier for the cryptocurrency

Example:

"bitcoin"

contractAddress
string

Smart contract address for the token

Example:

"0xa0b86a33e6776e2e09e384b0c92fceaade8fa82f"

contractAddresses
object[]

Array of contract addresses across different blockchains

decimals
number

Number of decimal places for the token

Example:

18

liquidityScore
number

Liquidity score of the cryptocurrency (0-100)

Example:

85.5

volatilityScore
number

Volatility score of the cryptocurrency (0-100)

Example:

42.3

marketCapScore
number

Market capitalization score (0-100)

Example:

95.8

riskScore
number

Overall risk score of the cryptocurrency (0-100)

Example:

25.7

avgChange
number

Average price change percentage

Example:

1.25

isStable
boolean

Indicates if the cryptocurrency is a stablecoin. Only present for stablecoins.

Example:

true

color
string

Brand color of the cryptocurrency in hex format (without #). Only present for coins that have it defined.

Example:

"FF9500"

allTimeHigh
number

All-time high price in the requested currency. Only present for coins that have it defined.

Example:

126080

allTimeLow
number

All-time low price in the requested currency. Only present for coins that have it defined.

Example:

67.81