The Crypto Indicator Your Models Are Missing.

Every request is authenticated with your API key, passed as the api_key parameter. Generate one from your account and claim 100 free credits. Keep it private, and regenerate it anytime if it is exposed.

The endpoint accepts GET and returns JSON from https://cfgi.io/api/api_request_v2.php.

Use ALL=1 only when you need every 15-minute source row; filtered hourly, 4-hour or daily snapshots are lighter.

The period parameter maps onto CFGI's four crypto timeframes.

Choose what comes back with fields=. Every response also includes three fields automatically: token (the asset symbol), date (UTC time of the reading) and classification(the score's sentiment band: Extreme Fear, Fear, Neutral, Greed or Extreme Greed).

Each value is a 0 to 100 score. cfgi and price return under their own name; the ten indicators return prefixed data_ (so whales arrives as data_whales). Each field adds one credit per token, per value.

See the score, classification and all ten indicators live, with history, on any token page, for example the Bitcoin Fear and Greed Index, or the whole-market index.

One credit = 1 field × 1 token × 1 value. The cost of any call is the product of the three.

Successful calls return a JSON array. Every response also carries billing headers: X-Credits-Used, X-Credits-Remaining, X-Fields-Requested and X-Tokens-Requested. Use them to track usage from each response.

[
  {
    "token": "BTC",
    "date": "2026-06-19 16:00:00",
    "price": 30000,
    "cfgi": 38,
    "classification": "Fear",
    "data_volatility": 41,
    "data_volume": 52,
    "data_impulse": 34,
    "data_technical": 47,
    "data_social": 55,
    "data_dominance": 60,
    "data_trends": 33,
    "data_whales": 72,
    "data_orders": 49
  }
]

{
  "error": "Insufficient credits.",
  "credits_needed": 20,
  "credits_available": 5,
  "calculation": "4 fields x 5 tokens = 20 credits"
}

Skip polling — have CFGI push each new reading to your endpoint the instant it is scored. Set one up in your account API tab: paste your URL, pick a token, a timeframe and the signals you want. We hand you a signing secret.

1. Add a webhook in your account: URL · token · timeframe · fields.
2. Each time that token and timeframe scores a new reading, we POST the JSON payload to your URL.
3. Verify the X-CFGI-Signature header, then act on the data.

POST https://your-app.com/hooks/cfgi
{
  "event": "score.updated",
  "token": "BTC",
  "period": "4h",
  "cfgi": 38,
  "classification": "Fear",
  "date": "2026-06-19 16:00:00"
}

import crypto from 'node:crypto'
// rawBody = the exact bytes you received (do not re-serialize)
const signature = req.headers['x-cfgi-signature']
const expected = 'sha256=' + crypto.createHmac('sha256', YOUR_SECRET).update(rawBody).digest('hex')
if (signature !== expected) return res.status(401).end()
// signature valid — handle JSON.parse(rawBody)