Market overview

Individual pair data tells you what a symbol is doing; this endpoint tells you what the market is doing. It aggregates the whole-market snapshot into regime-level readings (how one-sided the day is, how fearful or greedy the tape looks, where the volume is concentrating) plus the ranked movers lists from the Osiris market page. It is the natural first call of any session: many strategies read the regime here before deciding how to treat individual signals.

Request

curl "https://osiristrader.com/api/v1/market/overview?count=5" \
  -H "Authorization: Bearer osk_YOUR_KEY"

Response

{
  "overview": {
    "ts": 1783877000000,
    "pairs": 527, "up": 214, "down": 313,
    "avgChange": -0.56,
    "totalVol24h": 24985330427,
    "btc": { "price": 63516.6, "change": 0.04 }
  },
  "widgets": {
    "fng": {
      "value": 47,
      "components": { "momentum": 44.4, "breadth": 40.6, "trend": 58.3, "funding": 21.1, "buyPressure": 71.1, "volatility": 63.1 }
    },
    "dominance": {
      "btc": 33.13, "eth": 23.66, "btcVol24h": 8278507554,
      "allVol24h": 26381220102,
      "classes": [
        { "key": "crypto",    "vol": 24985330427, "pct": 94.71 },
        { "key": "stock",     "vol": 1104883340,  "pct": 4.19 },
        { "key": "commodity", "vol": 291006335,   "pct": 1.10 }
      ]
    }
  },
  "sections": {
    "gainers":    [ { "pair": "WIFUSDT", "price": 1.084, "change": 12.4, "vol": { "...": "..." }, "ticker": { "base_asset": "WIF", "precision": 4 } } ],
    "losers":     [ "..." ],
    "volume":     [ "..." ],
    "volatility": [ "..." ],
    "funding":    [ "..." ],
    "trades":     [ "..." ],
    "volSpikes":  [ "..." ],
    "pressure":   [ "..." ]
  }
}

Breadth (overview)

up/down count pairs by the sign of their 24h change, avgChange is the unweighted mean across all pairs, and totalVol24h sums quote volume market-wide. Breadth is the fastest sanity check there is: a green BTC with 313 of 527 pairs red is a very different market than the same BTC candle with breadth confirming. btc is included precisely so you can make that comparison in one glance.

The Fear & Greed composite

Most fear & greed indices you'll find online blend social sentiment, Google trends and survey-ish inputs, and update daily. Ours is deliberately different: it is computed entirely from the live futures tape, refreshes every 10 seconds, and every input is a number you can independently verify from this same API. It scores 0 (extreme fear) to 100 (extreme greed) from six sub-scores, each mapped so 50 is neutral:

The components are the interesting part. A composite of 50 can be a genuinely neutral market, or violent disagreement, like euphoric funding (90) against panicked volatility (10). Divergences between components often say more than the headline number: funding-greed with breadth-fear is the classic "crowded longs on a narrowing advance" configuration.

Two components can report null, and the composite redistributes their weight instead of faking a neutral reading: buyPressure is null on a venue view without a public trade tape, and trend is null while its level history is still building (the first day after a fresh deployment). trend is also the one market-wide component: it describes the merged crypto market on every venue view, because "where is the market relative to its week" has no per-venue answer.

Dominance

dominance is volume dominance on the perpetuals we track (BTC's and ETH's share of total 24h quote volume), not the market-cap dominance from spot data sites. For futures traders this is the more actionable reading: it answers "where is today's trading actually happening?". Falling BTC volume share with rising total volume is the signature of an alt rotation; spiking BTC share usually marks risk-off concentration. The btc/eth shares are denominated in crypto volume only; classes splits the full universe by asset class (crypto, stock, commodity — tokenized equities and commodities trade as ordinary perpetuals on these venues), with pct taken against allVol24h, the all-class total.

The eight ranked sections

Each row is the pair's full market-snapshot object (see Market snapshot) plus a ticker block with base_asset, precision and icon: enough to render a movers widget with zero additional requests. For ranking by metrics beyond these eight (specific volatility estimators, order-flow z-scores, trend scores…), use Rankings.