Global

The whole-market derivatives board in one endpoint: total open interest with its crypto-versus-RWA split, 24-hour liquidations, an unweighted average RSI across the most-traded perps, the Altcoin Season Index, and a ranked per-asset table. One universe covers crypto perps and every RWA perp class (equities, pre-IPO, ETFs, indices, commodities and FX), so a single call answers "what is the market doing" across both spines.

GET/v1/global/overview

Get the global overview

Returns market-wide metrics plus the row table for one asset class. The metrics are identical on every tab: they describe the whole market, not the selected class.

Query parameters

Name
tab
Type
string
Description
Which universe to return rows for. One of crypto, equity, preipo, etf, index, commodity, fx. Defaults to crypto. Thematic baskets such as MAG7 have no tab in v1 and are rejected.
Name
limit
Type
integer
Description
Maximum rows per page (1 to 1000). Enables cursor pagination; when set, the response returns rows only and omits the metrics block.
Name
cursor
Type
string
Description
Opaque pagination cursor from a previous response.

Metric definitions

Open interest sums the latest reading per venue across both spines. A symbol listed by both is counted once, on the RWA side. TSLA and NVDA, for example, run as equity perps on Bybit and Binance as well as on the RWA venues. The 24-hour change compares a matched symbol set at both ends of the window.

Liquidations are crypto-only: no RWA perp venue publishes a liquidation feed. They arrive as hourly buckets, so the newest bucket is still accumulating and the window is a rolling 23-24 hours.

AVG RSI is Wilder's RSI(14) on daily closes, averaged unweighted across the actively trading crypto perps that have enough history, ranked by market cap. A weighted average collapses toward BTC's own RSI, which a trader can already read on a chart. Stablecoins and tokenized metals are excluded, because both sit near 50 by construction and carry no momentum signal. Coins that have stopped printing daily candles are excluded too, so the reading is never a frozen one. Symbols with fewer than 15 daily candles are skipped rather than counted as neutral; avgRsiSampleSize reports how many contributed.

Altcoin Season Index is the share of the top 50 coins by market cap that outperformed BTC over the trailing 90 days, per the Blockchaincenter definition. The 90-day window comes from each coin's daily price series, refreshed once a day, so all 50 constituents are measured against the same window and altcoinSeasonSampleSize reports 50. It excludes BTC itself, stablecoins, tokenized metals, and wrapped or staked derivatives, because leaving five ETH derivatives in would count one signal five times; the top 50 is taken after those exclusions so the denominator is always 50 real alts. Scores of 25 or below read as Bitcoin Season, 75 and above as Altcoin Season.

Column availability by tab

Liquidations appear on crypto only. A venues count (how many venues list the underlying) appears on the RWA tabs instead. Market cap is absent on preipo and index, because OPENAI and SPX do not have one.

Freshness

Open interest, funding and RWA rows refresh on a 30-minute schedule and are marked stale after 45 minutes. Liquidations lag by up to one hourly bucket, and market cap by up to two hours. The response carries updatedAt and isStale so a client can surface the age rather than implying live data.

Request

GET

/v1/global/overview

curl https://www.sharpe.ai/api/v1/global/overview?tab=crypto \
  -H "Authorization: Bearer {token}"

Response

{
  "meta": {
    "request_id": "req_1bd292a1da57",
    "timestamp": "2026-07-31T08:09:08.021Z",
    "elapsed_ms": 412
  },
  "data": {
    "tab": "crypto",
    "updatedAt": "2026-07-31T08:09:08.021Z",
    "isStale": false,
    "metrics": {
      "openInterestUsd": 41920000000,
      "openInterestChange24hPct": -0.16,
      "cryptoOpenInterestUsd": 33370000000,
      "rwaOpenInterestUsd": 8550000000,
      "liquidations24hUsd": 56370000,
      "liquidationsChange24hPct": -36.6,
      "avgRsi": 46.42,
      "avgRsiSampleSize": 87,
      "altcoinSeasonIndex": 68,
      "altcoinSeasonSampleSize": 50,
      "classBreakdown": [
        { "tab": "crypto", "label": "Crypto", "openInterestUsd": 33370000000, "symbolCount": 91 }
      ]
    },
    "rows": [
      {
        "rank": 1,
        "symbol": "BTC",
        "name": "Bitcoin",
        "price": 63872,
        "priceChange24hPct": -0.12,
        "fundingRate": 0.000041,
        "volume24hUsd": 28980000000,
        "marketCapUsd": 1280000000000,
        "openInterestUsd": 15790000000,
        "oiChange1hPct": 0.06,
        "oiChange24hPct": 0.76,
        "liquidations24hUsd": 26500000,
        "venueCount": 5,
        "isStale": false
      }
    ]
  }
}