Skip to main content
GET
/
coins
/
{coinId}
Get detailed information about a specific cryptocurrency using coinId. 
curl --request GET \
  --url https://openapiv1.coinstats.app/coins/{coinId} \
  --header 'X-API-KEY: <api-key>'
{
  "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,
  "websiteUrl": "https://bitcoin.org",
  "redditUrl": "https://reddit.com/r/bitcoin",
  "twitterUrl": "https://twitter.com/bitcoin",
  "contractAddress": "0xa0b86a33e6776e2e09e384b0c92fceaade8fa82f",
  "contractAddresses": [
    {
      "blockchain": "ethereum",
      "contractAddress": "0xa0b86a33e6776e2e09e384b0c92fceaade8fa82f"
    }
  ],
  "decimals": 18,
  "explorers": [
    "https://blockstream.info"
  ],
  "liquidityScore": 85.5,
  "volatilityScore": 42.3,
  "marketCapScore": 95.8,
  "riskScore": 25.7,
  "avgChange": 1.25
}
1 credit per request

Authorizations

​
X-API-KEY
string
header
required

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

Path Parameters

​
coinId
string
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

​
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"]
​
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

⌘I