Skip to main content

GET /v1/sentiment

Returns market sentiment indicators including the Fear & Greed Index and Coinbase premium (institutional demand proxy).

Example

curl "https://api.crypton.dev/v1/sentiment"
{
  "status": "ok",
  "timestamp": 1709640000000,
  "data": {
    "fear_greed_index": 18,
    "fear_greed_label": "Extreme Fear",
    "coinbase_premium": 0.052,
    "btc_usd_coinbase": 71240.00,
    "btc_usdt_avg": 71203.00
  }
}

Field Reference

FieldTypeDescriptionGranularityExample
fear_greed_indexintegerCrypto Fear & Greed Index (0–100). 0 = Extreme Fear, 100 = Extreme Greed~24h (daily update)18
fear_greed_labelstringHuman-readable label for the index value~24h"Extreme Fear"
coinbase_premiumnumberBTC price difference: Coinbase USD vs avg USDT exchanges (%). Positive = US institutional buying~30s computed0.052
btc_usd_coinbasenumberBTC/USD price on Coinbase Exchange~30s71240.00
btc_usdt_avgnumberAverage BTC/USDT price across other exchanges~30s aggregated71203.00

Data Sources

  • Fear & Greed Index: Alternative.me API, updated daily. Combines volatility, market momentum/volume, social media, BTC dominance, and Google Trends.
  • Coinbase Premium: Computed in real-time by comparing Coinbase Exchange BTC/USD vs average BTC/USDT from Binance, Bybit, OKX. Positive premium indicates US institutional demand.

Live Testing

curl -s "https://api.crypton.dev/v1/sentiment" | jq .

Response Fields

data.fear_greed_index
integer
Crypto Fear & Greed Index (0–100).
RangeLabel
0–24Extreme Fear
25–49Fear
50Neutral
51–74Greed
75–100Extreme Greed
data.fear_greed_label
string
Human-readable sentiment label.
data.coinbase_premium
number
Percentage difference between Coinbase BTC/USD and average BTC/USDT. Positive = US institutional buying. Calculated as: (coinbase_price - usdt_avg) / usdt_avg × 100.
data.btc_usd_coinbase
number
BTC price on Coinbase (USD pair).
data.btc_usdt_avg
number
Average BTC price across USDT pairs.