Carry Oracle — API docs

Hourly funding for every perp on every Hyperliquid dex (main + HIP-3), kept beyond the 500 h the Hyperliquid API returns. Below: real responses from the latest hourly snapshot, truncated to a few rows (subscribers get every row, in real time).

Free trial key: POST /v1/keys/trial {"email":"you@example.com"} → dsi_trial_…, 200 calls, 7 days, no card (or the form on /carry). Leaderboard (public, 1 h delay): /carry/leaderboard.

Access: header X-API-KEY: dsi_carry_…. Price: US$100/month flat, unlimited calls. Card: /v1/carry/checkout · USDC (x402, Base or Solana): POST /v1/keys/x402/carry_month = 30 days. MCP tools carry_* at /mcp. Without a key every route answers 402 with how to pay. Free: /v1/carry/stats. Product page: /carry.

Query parameters: funding-matrix ?dex=xyz&min_vol= · xdex / spot-perp ?min_vol=100000&limit=50 · history /{coin}?hours=720 (HIP-3 coins prefixed, e.g. xyz:NBIS) · naked ?min_abs_apr=0.5&min_vol=.

GET /v1/carry/funding-matrix

{
  "as_of": "2026-11-20T12:00:00.000Z",
  "count": 151,
  "items": [
    {
      "coin": "INIT",
      "dex": "main",
      "base": "INIT",
      "funding_1h": -0.0004422251,
      "funding_apr": -3.8739,
      "mark": 0.098594,
      "oi_usd": 1002524,
      "vol24_usd": 1485897,
      "spot": null
    },
    {
      "coin": "xyz:GIGADEV",
      "dex": "xyz",
      "base": "GIGADEV",
      "funding_1h": -0.0004204756,
      "funding_apr": -3.6834,
      "mark": 29.616,
      "oi_usd": 1871862,
      "vol24_usd": 1790729,
      "spot": null
    },
    {
      "coin": "io:PRL",
      "dex": "io",
      "base": "PRL",
      "funding_1h": -0.0003173814,
      "funding_apr": -2.7803,
      "mark": 2.0454,
      "oi_usd": 8250462,
      "vol24_usd": 7055371,
      "spot": null
    },
    {
      "coin": "xyz:SMSN",
      "dex": "xyz",
      "base": "SMSN",
      "funding_1h": -0.000212806,
      "funding_apr": -1.8642,
      "mark": 133.85,
      "oi_usd": 39264088,
      "vol24_usd": 57284221,
      "spot": null
    }
  ],
  "disclaimer": "Market data and analytics only — not a signal, not investment advice. Informação e análise, não é recomendação de investimento."
}

GET /v1/carry/xdex

{
  "as_of": "2026-11-20T12:00:00.000Z",
  "delay_h": 0,
  "count": 14,
  "items": [
    {
      "base": "TTWO",
      "legs": [
        {
          "coin": "para:TTWO",
          "dex": "para",
          "funding_apr": 0.0657,
          "funding_apr_14d": 0.8343,
          "hours_positive_14d": 0.87,
          "hours_14d": 336,
          "vol24_usd": 415107,
          "oi_usd": 2038265,
          "mark": 210.535
        },
        {
          "coin": "xyz:TTWO",
          "dex": "xyz",
          "funding_apr": -0.2879,
          "funding_apr_14d": 0.3269,
          "hours_positive_14d": 0.85,
          "hours_14d": 261,
          "vol24_usd": 10440289,
          "oi_usd": 2414524,
          "mark": 210.32
        }
      ],
      "spread_apr_now": 0.3536,
      "spread_apr_14d": 0.5074,
      "basis_pct": 0.102,
      "min_leg_vol24_usd": 415107
    },
    {
      "base": "NBIS",
      "legs": [
        {
          "coin": "io:NBIS",
          "dex": "io",
          "funding_apr": 0.36,
          "funding_apr_14d": 0.2269,
          "hours_positive_14d": 0.82,
          "hours_14d": 336,
          "vol24_usd": 3092743,
          "oi_usd": 4376717,
          "mark": 91.626
        },
        {
          "coin": "xyz:NBIS",
          "dex": "xyz",
          "funding_apr": 0.1719,
          "funding_apr_14d": 0.0836,
          "hours_positive_14d": 0.82,
          "hours_14d": 336,
          "vol24_usd": 57852139,
          "oi_usd": 42252263,
          "mark": 91.403
        }
      ],
      "spread_apr_now": 0.1881,
      "spread_apr_14d": 0.1433,
      "basis_pct": 0.244,
      "min_leg_vol24_usd": 3092743
    }
  ],
  "disclaimer": "Market data and analytics only — not a signal, not investment advice. Informação e análise, não é recomendação de investimento."
}

GET /v1/carry/spot-perp

{
  "as_of": "2026-11-20T12:00:00.000Z",
  "count": 9,
  "items": [
    {
      "base": "PURR",
      "perp": "PURR",
      "funding_apr": 0.1095,
      "funding_apr_14d": 0.2077,
      "hours_positive_14d": 1,
      "hours_14d": 336,
      "perp_mark": 0.078347,
      "spot_mark": 0.078507,
      "spot_pair": "PURR/USDC",
      "basis_pct": -0.204,
      "perp_vol24_usd": 793669,
      "spot_vol24_usd": 930454,
      "oi_usd": 8347213
    },
    {
      "base": "BTC",
      "perp": "BTC",
      "funding_apr": -0.0114,
      "funding_apr_14d": 0.0803,
      "hours_positive_14d": 0.91,
      "hours_14d": 336,
      "perp_mark": 61640,
      "spot_mark": 61625,
      "spot_pair": "@142",
      "basis_pct": 0.024,
      "perp_vol24_usd": 5186181102,
      "spot_vol24_usd": 45021847,
      "oi_usd": 2436628021
    },
    {
      "base": "HYPE",
      "perp": "HYPE",
      "funding_apr": -0.0065,
      "funding_apr_14d": 0.0656,
      "hours_positive_14d": 0.82,
      "hours_14d": 336,
      "perp_mark": 63.703,
      "spot_mark": 63.751,
      "spot_pair": "@107",
      "basis_pct": -0.075,
      "perp_vol24_usd": 763087543,
      "spot_vol24_usd": 83480769,
      "oi_usd": 1182245390
    }
  ],
  "disclaimer": "Market data and analytics only — not a signal, not investment advice. Informação e análise, não é recomendação de investimento."
}

GET /v1/carry/history/BTC?hours=4

{
  "coin": "BTC",
  "dex": "main",
  "base": "BTC",
  "hours": 4,
  "items": [
    {
      "at": "2026-11-20T09:00:00.000Z",
      "funding_1h": -0.0000165409,
      "funding_apr": -0.1449,
      "premium": -0.0005274697,
      "mark": 61764,
      "oi_usd": 2513435920,
      "vol24_usd": 5035234560,
      "src": "snapshot"
    },
    {
      "at": "2026-11-20T10:00:00.000Z",
      "funding_1h": -0.000006975,
      "funding_apr": -0.0611,
      "premium": -0.0002624034,
      "mark": 61701,
      "oi_usd": 2476573451,
      "vol24_usd": 5046609423,
      "src": "snapshot"
    },
    {
      "at": "2026-11-20T11:00:00.000Z",
      "funding_1h": 0.0000024338,
      "funding_apr": 0.0213,
      "premium": -0.0005160708,
      "mark": 61977,
      "oi_usd": 2448427279,
      "vol24_usd": 5142807057,
      "src": "snapshot"
    },
    {
      "at": "2026-11-20T12:00:00.000Z",
      "funding_1h": -0.000001303,
      "funding_apr": -0.0114,
      "premium": -0.0001978239,
      "mark": 61640,
      "oi_usd": 2436628021,
      "vol24_usd": 5186181102,
      "src": "snapshot"
    }
  ]
}

GET /v1/carry/naked

{
  "as_of": "2026-11-20T12:00:00.000Z",
  "threshold_apr": 0.5,
  "count": 55,
  "items": [
    {
      "coin": "mkts:BVIV",
      "dex": "mkts",
      "funding_apr_now": -14.0826,
      "funding_apr_14d": -7.5477,
      "hours_above_threshold_14d": 330,
      "hours_14d": 336,
      "oi_usd": 317181,
      "vol24h_usd": 146549,
      "why_no_hedge": "no_spot_no_xdex_pair"
    },
    {
      "coin": "xyz:CAMBRICON",
      "dex": "xyz",
      "funding_apr_now": -13.0389,
      "funding_apr_14d": 0.0233,
      "hours_above_threshold_14d": 289,
      "hours_14d": 336,
      "oi_usd": 20526,
      "vol24h_usd": 7587,
      "why_no_hedge": "no_spot_no_xdex_pair"
    },
    {
      "coin": "xyz:BIRD",
      "dex": "xyz",
      "funding_apr_now": 11.8949,
      "funding_apr_14d": 0.6383,
      "hours_above_threshold_14d": 261,
      "hours_14d": 336,
      "oi_usd": 39667,
      "vol24h_usd": 59547,
      "why_no_hedge": "no_spot_no_xdex_pair"
    }
  ],
  "disclaimer": "Market data and analytics only — not a signal, not investment advice. Informação e análise, não é recomendação de investimento."
}

GET /v1/carry/watchdog

{
  "as_of": "2026-11-20T12:00:00.000Z",
  "note": "7-day changes need 7 days of hourly snapshots (recorded since 2026-10-03); null until then.",
  "dexes": [
    {
      "dex": "main",
      "markets": 235,
      "active": 179,
      "zero_oi": 0,
      "delisted": 56,
      "oi_usd": 6432714636,
      "vol24h_usd": 7852361089,
      "risk_flags": []
    },
    {
      "dex": "xyz",
      "markets": 147,
      "active": 123,
      "zero_oi": 0,
      "delisted": 24,
      "oi_usd": 4131856421,
      "vol24h_usd": 6629018270,
      "risk_flags": []
    },
    {
      "dex": "io",
      "markets": 24,
      "active": 17,
      "zero_oi": 0,
      "delisted": 7,
      "oi_usd": 144927687,
      "vol24h_usd": 257764421,
      "risk_flags": []
    },
    {
      "dex": "para",
      "markets": 40,
      "active": 33,
      "zero_oi": 0,
      "delisted": 7,
      "oi_usd": 14126415,
      "vol24h_usd": 5944286,
      "risk_flags": []
    },
    {
      "dex": "mkts",
      "markets": 24,
      "active": 1,
      "zero_oi": 0,
      "delisted": 23,
      "oi_usd": 317181,
      "vol24h_usd": 146549,
      "risk_flags": []
    },
    {
      "dex": "flx",
      "markets": 16,
      "active": 0,
      "zero_oi": 0,
      "delisted": 16,
      "oi_usd": 0,
      "vol24h_usd": 0,
      "risk_flags": [
        "dex_no_active_markets"
      ]
    },
    {
      "dex": "vntl",
      "markets": 15,
      "active": 0,
      "zero_oi": 0,
      "delisted": 15,
      "oi_usd": 0,
      "vol24h_usd": 0,
      "risk_flags": [
        "dex_no_active_markets"
      ]
    },
    {
      "dex": "hyna",
      "markets": 25,
      "active": 0,
      "zero_oi": 0,
      "delisted": 25,
      "oi_usd": 0,
      "vol24h_usd": 0,
      "risk_flags": [
        "dex_no_active_markets"
      ]
    },
    {
      "dex": "km",
      "markets": 23,
      "active": 0,
      "zero_oi": 0,
      "delisted": 23,
      "oi_usd": 0,
      "vol24h_usd": 0,
      "risk_flags": [
        "dex_no_active_markets"
      ]
    },
    {
      "dex": "abcd",
      "markets": 1,
      "active": 0,
      "zero_oi": 0,
      "delisted": 1,
      "oi_usd": 0,
      "vol24h_usd": 0,
      "risk_flags": [
        "dex_no_active_markets"
      ]
    },
    {
      "dex": "cash",
      "markets": 17,
      "active": 0,
      "zero_oi": 0,
      "delisted": 17,
      "oi_usd": 0,
      "vol24h_usd": 0,
      "risk_flags": [
        "dex_no_active_markets"
      ]
    }
  ],
  "markets": [
    {
      "coin": "BTC",
      "dex": "main",
      "status": "active",
      "growth_mode": null,
      "max_leverage": 40,
      "oi_usd": 2436628021,
      "oi_change_7d_pct": -10.1,
      "vol24h_usd": 5186181102,
      "vol_change_7d_pct": -11.6,
      "last_funding_at": "2026-11-20T12:00:00.000Z",
      "tracked_since": "2026-10-04T00:00:00.000Z",
      "risk_flags": []
    },
    {
      "coin": "xyz:ANT",
      "dex": "xyz",
      "status": "active",
      "growth_mode": "enabled",
      "max_leverage": 10,
      "oi_usd": 261470653,
      "oi_change_7d_pct": 146,
      "vol24h_usd": 1713190773,
      "vol_change_7d_pct": 4427.4,
      "last_funding_at": "2026-11-20T12:00:00.000Z",
      "tracked_since": "2026-10-26T13:00:00.000Z",
      "risk_flags": []
    },
    {
      "coin": "ETH",
      "dex": "main",
      "status": "active",
      "growth_mode": null,
      "max_leverage": 25,
      "oi_usd": 1075564436,
      "oi_change_7d_pct": -25.6,
      "vol24h_usd": 971894961,
      "vol_change_7d_pct": -46.9,
      "last_funding_at": "2026-11-20T12:00:00.000Z",
      "tracked_since": "2026-10-04T00:00:00.000Z",
      "risk_flags": []
    }
  ],
  "disclaimer": "Market data and analytics only — not a signal, not investment advice. Informação e análise, não é recomendação de investimento."
}

Pay per call (USDC, x402) — no subscription

routeUS$ per callprepaid-pack credits
funding-matrix0.0330
xdex0.0550
spot-perp0.0330
history/{coin}0.0220
naked0.0110
watchdog0.0110

Call without a key, answer the 402 with USDC on Base or Solana. Around 3,000 calls/month the flat US$100 subscription is cheaper.

Carry Desk routes (subscription only: US$450/month · US$4,500/year · limited seats)

Method

Field dictionary

fieldmeaningunitsource
funding_1hfunding rate paid per hour (positive: longs pay shorts)fraction per hourHyperliquid metaAndAssetCtxs / fundingHistory
funding_apr / funding_apr_nowfunding_1h × 24 × 365fraction (0.31 = 31 % a year)derived
funding_apr_14dmean hourly funding over the last 336 h, annualisedfractionour hourly history
hours_positive_14dshare of the last 336 h with positive funding0–1our hourly history
spread_apr_now / spread_apr_14dfunding of the highest-funding leg minus the lowest (xdex)fractionderived
basis_pctmark of the first leg / mark of the second − 1 (xdex), or perp / spot − 1 (spot-perp)%markPx
min_leg_vol24_usd24 h notional volume of the thinner legUSDdayNtlVlm
oi_usdopen interest × markUSDopenInterest × markPx
vol24_usd / vol24h_usd24 h notional volumeUSDdayNtlVlm
spot.mark / spot_markspot price of the same asset (U-tokens mapped: UBTC→BTC, UETH→ETH…)USDspotMetaAndAssetCtxs
hours_above_threshold_14dhours in the last 336 with |funding| above the threshold (naked)hoursour hourly history
why_no_hedgeno_spot (main dex) or no_spot_no_xdex_pair (HIP-3)enumderived
statusactive · zero_oi · delisted (watchdog)enummeta + our snapshots
oi_change_7d_pct / vol_change_7d_pctchange versus the snapshot 7 days earlier (null until 7 days of snapshots exist)%our snapshots
srcsnapshot (recorded by us at :03 every hour) or history (recovered from Hyperliquid's 500 h window)enum—

Every value can be checked against Hyperliquid's public API. Marbella Collins LLC · contact@degenscan.io · Market data and analytics only — not a signal, not investment advice. Informação e análise, não é recomendação de investimento.