Discovery and markets API
Is the crypto market greedy or fearful, and is it altcoin season?
Crypto fear and greed index, altcoin season index, bitcoin dominance and the US exchange premium as daily series over 30, 90 or 365 days or all history.
/api/external/discovery/market-sentimentWhat it returns
Four market sentiment series over the last 30, 90 or 365 days or their whole history, oldest first, at most one point per UTC day. Each window counts back from that series' own newest point.
fearGreed— the crypto fear and greed index, 0 (extreme fear) to 100 (extreme greed), published once a day since 2018-02-01 (the newest point is today's), with bitcoin's USD price when it was published. A few days were never published (gaps of 2 to 15 days).altcoinSeason— the altcoin season index, 0 (bitcoin season) to 100 (altcoin season), daily since 2017-04-03, the newest point today's; a few days are missing (gaps of 2 to 3 days).bitcoinDominance— bitcoin's share of the whole crypto market cap in percent, its own market cap and price, EVERY THIRD DAY since 2013-05-01.dominancePercentisnullon two days that have no figure.coinbasePremium— how far bitcoin trades above (positive) or below (negative) the reference price on the largest US exchange, in USD and percent, daily for the last 1,000 days at most; the newest point is today's and still moving.
Only fearGreed is required: any other series that cannot be read this time is null.
Chains
This endpoint is not tied to a chain: it takes no chain in its request.
Request
Send your key in the x-dex-data-key header. Replace each <placeholder> with a real value.
curl -H "x-dex-data-key: $DEXDATA_API_KEY" \ "https://api.dexdata.io/api/external/discovery/market-sentiment"
| Parameter | Description |
|---|---|
daysquery · string · optional | Trailing window in days back from each series' newest point, or all. Defaults to 30. days ≤ 90 keeps the answer under 32 KB.3090365all |
Response fields
A JSON response. Every field is always present; null means the value could not be established, never zero.
| Field | Type | Description |
|---|---|---|
days | string | The window answered. |
fearGreed | object[] | The fear and greed index, one point per published day. |
fearGreed[].timestamp | integer | Unix seconds, 00:00 UTC of the day. |
fearGreed[].value | number | 0 = extreme fear, 100 = extreme greed. |
fearGreed[].priceUsd | number | null | Bitcoin's USD price when the day's index was published. |
altcoinSeason | object[] | null | The altcoin season index, daily; null when it could not be read this time. |
altcoinSeason[].timestamp | integer | Unix seconds, 00:00 UTC of the day. |
altcoinSeason[].value | number | 0 = bitcoin season, 100 = altcoin season. |
bitcoinDominance | object[] | null | Bitcoin dominance every third day; null when it could not be read this time. |
bitcoinDominance[].timestamp | integer | Unix seconds, 00:00 UTC of the day. |
bitcoinDominance[].dominancePercent | number | null | Bitcoin's share of the total crypto market cap, percent. |
bitcoinDominance[].bitcoinMarketCapUsd | number | null | Bitcoin's own market cap, USD. |
bitcoinDominance[].priceUsd | number | null | Bitcoin's USD price that day. |
coinbasePremium | object[] | null | The US exchange premium, daily; null when it could not be read this time. |
coinbasePremium[].timestamp | integer | Unix seconds, 00:00 UTC of the day. |
coinbasePremium[].premiumUsd | number | Bitcoin's price there minus the reference price, USD. Signed. |
coinbasePremium[].premiumPercent | number | The same premium in percent of the reference price. Signed. |
coinbasePremium[].coinbasePriceUsd | number | null | Bitcoin's USD price on that exchange. |
Start building with DexData today
Sign in, create a key and make your first call in a minute. Free credits every month, and you only pay for calls that succeed.
Get a free API key