{"uid":"cap_JbAE6wHIHQrmU9_SY7jkR","slug":"laevitas-derivatives-current-analytics-699b1e19","name":"Laevitas Derivatives Current Analytics","description":"Professional market data API for crypto derivatives, spot markets, prediction markets, Hyperliquid HyperCore data, proprietary volatility surfaces, and analytics.\n\n## Authentication\n\nUse an API key for authenticated REST requests:\n\n```http\nX-API-Key: your-api-key-here\n```\n\nData and history endpoints also accept x402 without an API key: 1, 5 or 10 credits ($0.001 each) for data up to 1 year, 1–3 years or older.\n\n**Subscriptions with USDC:** Premium and Enterprise can be purchased on Base or Solana for a month, a quarter, six months or a year. Access is prepaid, with no automatic renewal. [Buy a subscription](https://v3.laevitas.ch/profile/subscription/wallet) or read the [USDC subscription guide](/x402#subscriptions).\n\nThe subscription belongs to your signed-in Laevitas account; wallet sign-in does not require an email. Enterprise users generate an API key in V3 after activation. Plan and billing-period limits still apply. Subscription purchases are separate from API credit bundles.\n\nFor Claude MCP, add `https://apiv2.laevitas.ch/api/v1/mcp`, select **Sign in now → Register automatically**\nwith no custom headers, and authorize with your API key on the Laevitas page.\nDo not enter a client ID or secret manually. All OAuth clients require PKCE S256.\nConnection guide: [MCP setup](/mcp). CIMD / published client identity is not supported.\n\n| Resource | Path |\n| --- | --- |\n| OpenAPI JSON | `GET /openapi.json` |\n| x402 discovery | `GET /.well-known/x402` |\n| Changelog | `GET /api/v1/changelog` |\n| WebSocket docs | `GET /websocket` |\n\n## REST Surfaces\n\n| Surface | Examples |\n| --- | --- |\n| Instruments | Cross-market contract reference data |\n| Futures | OHLCVT, trades, tickers, orderbook, liquidations, carry |\n| Perpetuals | OHLCVT, trades, funding, open interest, orderbook, liquidations |\n| Options | OHLCVT, trades, Greeks, volatility, flow, dealer GEX |\n| Options Backtests | Strategy templates, asynchronous submission, status, combined results, cancellation |\n| Vol Surface | Proprietary surface snapshots, slices, strikes, term structure, risk |\n| Spot | OHLCVT, ticker, trades, volume, L2 orderbook, snapshots |\n| Predictions | Polymarket instruments, categories, trades, ticker history |\n| Hyperliquid - HyperCore | Node-derived fills, liquidations, positions, funding, TWAPs, resting orders, L2 books |\n| Analytics | Realized volatility and derived metrics |\n\n## Pagination\n\nBacktests are asynchronous jobs, not paginated market-data queries. Start with\n`GET /api/v1/options/backtests/strategies`, submit with `POST /api/v1/options/backtests`,\nthen poll `/{id}` and retrieve `/{id}/result`. These responses have no data/meta wrapper.\n\nPaginated endpoints return the cursor at `meta.next_cursor`. Pass that value back as the `cursor` query parameter to fetch the next page.\n\n## WebSocket Streaming\n\nReal-time streams are documented at `/websocket`.\n\n| Data | Channel pattern |\n| --- | --- |\n| Trades | `trades.{market}.{exchange}.{instrument}` |\n| OHLC ticker | `ohlc.ticker.{market}.{exchange}.{instrument}.{timeframe}` |\n| OHLCVT | `ohlc.vt.{market}.{exchange}.{instrument}.{timeframe}` |\n\nVariables: `market` is one of `perpetuals`, `futures`, `options`, or `spot`; `timeframe` is one of `1m`, `5m`, `15m`, `1h`, `4h`, or `1d`.\n\n## Quick Start\n\n```bash\ncurl \"https://apiv2.laevitas.ch/api/v1/futures/ohlcvt?exchange=deribit&instrument_name=BTC-PERPETUAL\" \\\n  -H \"X-API-Key: your-api-key-here\"\n```","url":"https://apiv2.laevitas.ch/api/v1/derivatives/current-analytics?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["series"],"properties":{"hours":{"enum":["1","2","4","8","12","18","24","48","168","336","504","720"],"type":"string","description":"Required for market_oi_changes only; lookback hours, not days."},"period":{"type":"string","description":"Required for oi_gainers and price_gainers (1, 2, 4, 8, 12, 18, 24, 48, 168, 336, 504, 720 or ytd) and futures_oi_change_summary (whole hours or ytd)."},"series":{"enum":["perpetual_markets","futures_markets","currency_summary","perpetual_funding","futures_yield","market_oi_changes","futures_curve","oi_gainers","price_gainers","top_funding","futures_basis","oi_breakdown","volume_breakdown","futures_summary","futures_oi_change_summary","futures_currencies","futures_snapshot","perpetuals_by_venue","oi_change","perpetuals_snapshot","perpetual_oi_change_summary"],"type":"string"},"currency":{"type":"string","description":"Base asset. Required for perpetual_funding, futures_yield, futures_curve, futures_basis, perpetuals_by_venue and market_oi_changes; optional for the other series."},"exchange":{"type":"string","description":"Required for perpetual_markets, futures_markets, futures_snapshot, oi_gainers, price_gainers and top_funding; optional for futures_curve. Recent source venue identifier."},"maturity":{"type":"string","description":"futures_markets only: exact listed expiry DMMMYY, e.g. 25SEP26."},"venue_type":{"enum":["c","d"],"type":"string","description":"Funding/OI changes (optional) and the OI/volume breakdowns (required): centralized or decentralized legacy venue group."},"instrument_type":{"enum":["all","future","perpetual"],"type":"string","description":"Required for market_oi_changes (all, future or perpetual) and the gainers (future or perpetual)."}}},"responseSchema":{"type":"object","required":["meta","data"],"properties":{"data":{"anyOf":[{"type":"array","items":{"anyOf":[{"type":"object","required":["symbol","base_currency","margin","index_price","price","basis","apy","open_interest","open_interest_coin","oi_volume24h","volume24h","volume24h_coin","bid","ask","bid_amount","ask_amount","liquidations","funding","next_funding","long_short_ratio","avg_apr"],"properties":{"apy":{"type":"number","nullable":true,"description":"Stored annualized yield in percent. For perpetuals this is funding yield; for futures it is annualized carry. Not compounded APY despite the legacy name. Null means unavailable; zero remains zero."},"ask":{"type":"number","nullable":true,"description":"Best ask price at the selected snapshot, not a 24-hour low. Null means unavailable; zero remains zero."},"bid":{"type":"number","nullable":true,"description":"Best bid price at the selected snapshot, not a 24-hour high. Null means unavailable; zero remains zero."},"basis":{"type":"number","nullable":true,"description":"Stored futures/perpetual basis in the legacy source convention; not funding. Null means unavailable; zero remains zero."},"price":{"type":"number","nullable":true,"description":"Legacy normalized derivative price; not an option premium or a historical candle. Null means unavailable; zero remains zero."},"margin":{"type":"string","description":"Legacy margin category: coin or usd; not option call/put."},"symbol":{"type":"string","description":"Exact exchange instrument identifier."},"avg_apr":{"type":"object","nullable":true,"description":"Stored average annualized funding yield by lookback days, in percent.","additionalProperties":{"type":"number","nullable":true}},"funding":{"type":"number","nullable":true,"description":"Stored funding rate in percent for the source funding interval; not an annualized rate or universally eight-hour. Null means unavailable; zero remains zero."},"volume24h":{"type":"number","nullable":true,"description":"Stored rolling 24-hour USD volume. Not volume since midnight. Null means unavailable; zero remains zero."},"ask_amount":{"type":"number","nullable":true,"description":"Displayed best-ask size in the legacy source quantity convention; not 24-hour ask volume. Null means unavailable; zero remains zero."},"bid_amount":{"type":"number","nullable":true,"description":"Displayed best-bid size in the legacy source quantity convention; not 24-hour bid volume. Null means unavailable; zero remains zero."},"market_cap":{"type":"number","nullable":true,"description":"Current market-cap enrichment in USD; omitted when no key exists. Null means unavailable; zero remains zero."},"index_price":{"type":"number","nullable":true,"description":"Stored index reference, quote/USD units per underlying base unit according to source contract. Null means unavailable; zero remains zero."},"liquidations":{"type":"object","required":["long","short"],"properties":{"long":{"type":"number","nullable":true,"description":"Rolling 24-hour USD amount of long positions liquidated, not buy volume. Null means unavailable; zero remains zero."},"short":{"type":"number","nullable":true,"description":"Rolling 24-hour USD amount of short positions liquidated, not sell volume. Null means unavailable; zero remains zero."}},"additionalProperties":false},"next_funding":{"type":"number","nullable":true,"description":"Next announced funding rate in percent for the source interval. Null means unavailable; zero remains zero."},"oi_volume24h":{"type":"number","nullable":true,"description":"USD open interest divided by rolling 24-hour USD volume; dimensionless, not percent. Null means unavailable; zero remains zero."},"realized_vol":{"type":"object","nullable":true,"description":"Current source realised-volatility map keyed by lookback days; omitted when unavailable.","additionalProperties":{"type":"number","nullable":true}},"base_currency":{"type":"string","description":"Legacy normalized base asset code."},"open_interest":{"type":"number","nullable":true,"description":"Open interest in USD. Null means unavailable; zero remains zero."},"volume24h_coin":{"type":"number","nullable":true,"description":"Stored rolling 24-hour volume in base-asset units. Null means unavailable; zero remains zero."},"long_short_ratio":{"type":"number","nullable":true,"description":"Stored venue long/short ratio; not a cross-venue standardized metric. Null means unavailable; zero remains zero."},"open_interest_coin":{"type":"number","nullable":true,"description":"Open interest in base-asset units, not USD. Null means unavailable; zero remains zero."}},"additionalProperties":false},{"type":"object","required":["symbol","base_currency","margin","index_price","price","basis","apy","open_interest","open_interest_coin","oi_volume24h","volume24h","volume24h_coin","bid","ask","bid_amount","ask_amount","liquidations"],"properties":{"apy":{"type":"number","nullable":true,"description":"Stored annualized yield in percent. For perpetuals this is funding yield; for futures it is annualized carry. Not compounded APY despite the legacy name. Null means unavailable; zero remains zero."},"ask":{"type":"number","nullable":true,"description":"Best ask price at the selected snapshot, not a 24-hour low. Null means unavailable; zero remains zero."},"bid":{"type":"number","nullable":true,"description":"Best bid price at the selected snapshot, not a 24-hour high. Null means unavailable; zero remains zero."},"basis":{"type":"number","nullable":true,"description":"Stored futures/perpetual basis in the legacy source convention; not funding. Null means unavailable; zero remains zero."},"price":{"type":"number","nullable":true,"description":"Legacy normalized derivative price; not an option premium or a historical candle. Null means unavailable; zero remains zero."},"margin":{"type":"string","description":"Legacy margin category: coin or usd; not option call/put."},"symbol":{"type":"string","description":"Exact exchange instrument identifier."},"volume24h":{"type":"number","nullable":true,"description":"Stored rolling 24-hour USD volume. Not volume since midnight. Null means unavailable; zero remains zero."},"ask_amount":{"type":"number","nullable":true,"description":"Displayed best-ask size in the legacy source quantity convention; not 24-hour ask volume. Null means unavailable; zero remains zero."},"bid_amount":{"type":"number","nullable":true,"description":"Displayed best-bid size in the legacy source quantity convention; not 24-hour bid volume. Null means unavailable; zero remains zero."},"index_price":{"type":"number","nullable":true,"description":"Stored index reference, quote/USD units per underlying base unit according to source contract. Null means unavailable; zero remains zero."},"liquidations":{"type":"object","required":["long","short"],"properties":{"long":{"type":"number","nullable":true,"description":"Rolling 24-hour USD amount of long positions liquidated, not buy volume. Null means unavailable; zero remains zero."},"short":{"type":"number","nullable":true,"description":"Rolling 24-hour USD amount of short positions liquidated, not sell volume. Null means unavailable; zero remains zero."}},"additionalProperties":false},"oi_volume24h":{"type":"number","nullable":true,"description":"USD open interest divided by rolling 24-hour USD volume; dimensionless, not percent. Null means unavailable; zero remains zero."},"base_currency":{"type":"string","description":"Legacy normalized base asset code."},"open_interest":{"type":"number","nullable":true,"description":"Open interest in USD. Null means unavailable; zero remains zero."},"volume24h_coin":{"type":"number","nullable":true,"description":"Stored rolling 24-hour volume in base-asset units. Null means unavailable; zero remains zero."},"open_interest_coin":{"type":"number","nullable":true,"description":"Open interest in base-asset units, not USD. Null means unavailable; zero remains zero."}},"additionalProperties":false},{"type":"object","required":["currency","price","change","funding","next_fr","yield","ls_ratio","open_interest","open_interest_notional","open_interest_change_usd","open_interest_change_usd_percentage","open_interest_change_notional","open_interest_change_notional_percentage","volume","volume_notional","volume_change_usd","volume_change_usd_percentage","volume_change_notional","volume_change_notional_percentage","oi_volume_24h","markets","market_cap","realized_vol","sectors","total_long_usd","total_short_usd","liquidations"],"properties":{"price":{"type":"number","nullable":true,"description":"OI-weighted USD price from the latest perpetual contract observations. Only finite, positive prices and OI from the same observation contribute to the price. BINANCE ETHBTC is excluded from this price average because its quote is in BTC, not USD. A contract excluded from the price can still contribute to other totals. Null means no eligible price is available."},"yield":{"type":"number","nullable":true,"description":"Stored annualized funding yield in percent; not compounded APY. Null means unavailable; zero remains zero."},"change":{"type":"number","nullable":true,"description":"Absolute USD difference between current and approximately 24-hour-old weighted prices; not percent. Both use the same price-eligibility rules; unavailable prices make the change null. Null means unavailable; zero remains zero."},"volume":{"type":"number","nullable":true,"description":"Sum of latest rolling 24-hour USD-volume observations. Null means unavailable; zero remains zero."},"funding":{"type":"number","nullable":true,"description":"Stored funding rate in percent for the source funding interval; not an annualized rate or universally eight-hour. Null means unavailable; zero remains zero."},"markets":{"type":"array","items":{"type":"string"},"description":"Distinct contributing venue keys; not a completeness certificate."},"next_fr":{"type":"number","nullable":true,"description":"Next announced funding rate in percent for the source interval. Null means unavailable; zero remains zero."},"sectors":{"type":"array","items":{"type":"string"},"description":"Current sector labels from the existing constituent feed."},"currency":{"type":"string"},"ls_ratio":{"type":"number","nullable":true,"description":"Open-interest-weighted stored long/short ratio; venue definitions can differ. Null means unavailable; zero remains zero."},"market_cap":{"type":"number","nullable":true,"description":"Current market-cap enrichment in USD, not a value measured at every contract timestamp. Null means unavailable; zero remains zero."},"liquidations":{"type":"object","required":["long","short"],"properties":{"long":{"type":"number","nullable":true,"description":"Rolling 24-hour USD amount of long positions liquidated, not buy volume. Null means unavailable; zero remains zero."},"short":{"type":"number","nullable":true,"description":"Rolling 24-hour USD amount of short positions liquidated, not sell volume. Null means unavailable; zero remains zero."}},"additionalProperties":false},"realized_vol":{"type":"object","description":"Current realised-volatility enrichment; keys are lookback days, values are the source percentage convention.","additionalProperties":{"type":"number","nullable":true}},"oi_volume_24h":{"type":"number","nullable":true,"description":"Current USD OI divided by current rolling 24-hour USD volume; dimensionless. Null means unavailable; zero remains zero."},"open_interest":{"type":"number","nullable":true,"description":"Sum of latest perpetual USD open-interest observations. Null means unavailable; zero remains zero."},"total_long_usd":{"type":"number","nullable":true,"description":"Legacy duplicate of liquidations.long. Null means unavailable; zero remains zero."},"total_short_usd":{"type":"number","nullable":true,"description":"Legacy duplicate of liquidations.short. Null means unavailable; zero remains zero."},"volume_notional":{"type":"number","nullable":true,"description":"Sum of latest rolling 24-hour volume in base-asset units, not USD. Null means unavailable; zero remains zero."},"volume_change_usd":{"type":"number","nullable":true,"description":"Difference between current and approximately 24-hour-old rolling USD-volume observations. Null means unavailable; zero remains zero."},"open_interest_notional":{"type":"number","nullable":true,"description":"Sum of latest perpetual open interest in base-asset units, despite the legacy notional name. Null means unavailable; zero remains zero."},"volume_change_notional":{"type":"number","nullable":true,"description":"Difference between current and older rolling volume in base-asset units. Null means unavailable; zero remains zero."},"open_interest_change_usd":{"type":"number","nullable":true,"description":"Absolute USD OI change versus the approximately 24-hour-old comparison. Null means unavailable; zero remains zero."},"volume_change_usd_percentage":{"type":"number","nullable":true,"description":"Relative change between those rolling USD-volume observations, in percent. Null means unavailable; zero remains zero."},"open_interest_change_notional":{"type":"number","nullable":true,"description":"Absolute OI change in base-asset units. Null means unavailable; zero remains zero."},"volume_change_notional_percentage":{"type":"number","nullable":true,"description":"Relative change between those rolling base-unit-volume observations, in percent. Null means unavailable; zero remains zero."},"open_interest_change_usd_percentage":{"type":"number","nullable":true,"description":"Relative USD OI change in percent. Null means unavailable; zero remains zero."},"open_interest_change_notional_percentage":{"type":"number","nullable":true,"description":"Relative base-unit OI change in percent. Null means unavailable; zero remains zero."}},"additionalProperties":false},{"type":"object","required":["market","symbol","funding","next_fr","yield"],"properties":{"yield":{"type":"number","nullable":true,"description":"Stored annualized funding yield in percent; not compounded APY. Null means unavailable; zero remains zero."},"market":{"type":"string"},"symbol":{"type":"string"},"funding":{"type":"number","nullable":true,"description":"Stored funding rate in percent for the source funding interval; not an annualized rate or universally eight-hour. Null means unavailable; zero remains zero."},"next_fr":{"type":"number","nullable":true,"description":"Next announced funding rate in percent for the source interval. Null means unavailable; zero remains zero."}},"additionalProperties":false},{"type":"object","required":["market","maturity","value"],"properties":{"value":{"type":"number","nullable":true,"description":"Maximum stored annualized carry yield in percent among the selected market/expiry contracts, not their average. Null means unavailable; zero remains zero."},"market":{"type":"string"},"maturity":{"type":"string","description":"Listed expiry in DMMMYY format."}},"additionalProperties":false},{"type":"object","required":["market","open_interest_change","open_interest_change_perc","open_interest_notional_change","open_interest_notional_change_perc"],"properties":{"market":{"type":"string"},"open_interest_change":{"type":"number","nullable":true,"description":"Latest minus earliest venue-total USD open interest across matching contracts, after resolving retained replacements. Uses the two matching global boundary timestamps in the lookback, including its two-minute buffer. Null means unavailable; zero remains zero."},"open_interest_change_perc":{"type":"number","nullable":true,"description":"Relative change of venue-total USD OI, in percent; null when the earlier total is unavailable or zero. Null means unavailable; zero remains zero."},"open_interest_notional_change":{"type":"number","nullable":true,"description":"Latest minus earliest venue-total OI in base-asset units, not USD. Null means unavailable; zero remains zero."},"open_interest_notional_change_perc":{"type":"number","nullable":true,"description":"Relative change of venue-total base-unit OI, in percent; null when the earlier total is unavailable or zero. Null means unavailable; zero remains zero."}},"additionalProperties":false},{"type":"object","required":["market","maturity","value"],"properties":{"value":{"type":"number","nullable":true,"description":"Highest legacy normalized futures price among the selected market/expiry contracts at the latest observation; not an average, an option premium or a historical candle. Null means unavailable; zero remains zero."},"market":{"type":"string"},"maturity":{"type":"string","description":"Listed expiry in DMMMYY format."}},"additionalProperties":false},{"type":"object","required":["symbol","open_interest_change","open_interest_change_notional","open_interest_change_percentage"],"properties":{"symbol":{"type":"string","description":"Exact exchange instrument identifier."},"open_interest_change":{"type":"number","nullable":true,"description":"Latest minus earliest USD open interest of the contract within the lookback, at the venue-wide first and last observation times. Null means unavailable; zero remains zero."},"open_interest_change_notional":{"type":"number","nullable":true,"description":"Latest minus earliest open interest in base-asset units, not USD. Null means unavailable; zero remains zero."},"open_interest_change_percentage":{"type":"number","nullable":true,"description":"Relative USD open-interest change in percent; null when the earlier value is unavailable or zero. Null means unavailable; zero remains zero."}},"additionalProperties":false},{"type":"object","required":["symbol","price_change"],"properties":{"symbol":{"type":"string","description":"Exact exchange instrument identifier."},"price_change":{"type":"number","nullable":true,"description":"Latest minus earliest legacy normalized price within the lookback, at the venue-wide first and last observation times; an absolute difference, not percent. Null means unavailable; zero remains zero."}},"additionalProperties":false},{"type":"object","required":["symbol","funding","yield"],"properties":{"yield":{"type":"number","nullable":true,"description":"Stored annualized funding yield in percent; not compounded APY. Null means unavailable; zero remains zero."},"symbol":{"type":"string","description":"Exact exchange instrument identifier."},"funding":{"type":"number","nullable":true,"description":"Stored funding rate in percent for the source funding interval; not an annualized rate or universally eight-hour. Null means unavailable; zero remains zero."}},"additionalProperties":false},{"type":"object","required":["market","maturity","value"],"properties":{"value":{"type":"number","nullable":true,"description":"Highest stored basis among the selected market/expiry contracts at the latest observation, in the legacy basis convention; not an average. Null means unavailable; zero remains zero."},"market":{"type":"string"},"maturity":{"type":"string","description":"Listed expiry in DMMMYY format."}},"additionalProperties":false},{"type":"object","required":["market","total_usd","total_coin","future_usd","future_coin","perpetual_usd","perpetual_coin"],"properties":{"market":{"type":"string"},"total_usd":{"type":"number","nullable":true,"description":"Venue total open interest across dated futures and perpetuals, USD. Null means unavailable; zero remains zero."},"future_usd":{"type":"number","nullable":true,"description":"Dated futures open interest, USD. Null means unavailable; zero remains zero."},"total_coin":{"type":"number","nullable":true,"description":"Venue total open interest in base-asset units. Null means unavailable; zero remains zero."},"future_coin":{"type":"number","nullable":true,"description":"Dated futures open interest in base-asset units. Null means unavailable; zero remains zero."},"perpetual_usd":{"type":"number","nullable":true,"description":"Perpetual open interest, USD. Null means unavailable; zero remains zero."},"perpetual_coin":{"type":"number","nullable":true,"description":"Perpetual open interest in base-asset units. Null means unavailable; zero remains zero."}},"additionalProperties":false},{"type":"object","required":["market","total_usd","total_coin","future_usd","future_coin","perpetual_usd","perpetual_coin"],"properties":{"market":{"type":"string"},"total_usd":{"type":"number","nullable":true,"description":"Venue total 24-hour volume across dated futures and perpetuals, USD. Null means unavailable; zero remains zero."},"future_usd":{"type":"number","nullable":true,"description":"Dated futures 24-hour volume, USD. Null means unavailable; zero remains zero."},"total_coin":{"type":"number","nullable":true,"description":"Venue total 24-hour volume in base-asset units. Null means unavailable; zero remains zero."},"future_coin":{"type":"number","nullable":true,"description":"Dated futures 24-hour volume in base-asset units. Null means unavailable; zero remains zero."},"perpetual_usd":{"type":"number","nullable":true,"description":"Perpetual 24-hour volume, USD. Null means unavailable; zero remains zero."},"perpetual_coin":{"type":"number","nullable":true,"description":"Perpetual 24-hour volume in base-asset units. Null means unavailable; zero remains zero."}},"additionalProperties":false},{"type":"object","required":["symbol","currency","expiry","open_interest","open_interest_notional","volume","volume_notional","price","yield","basis","open_interest_volume","markets"],"properties":{"basis":{"type":"number","nullable":true,"description":"Open-interest-weighted basis in the legacy basis convention. Null means unavailable; zero remains zero."},"price":{"type":"number","nullable":true,"description":"Open-interest-weighted legacy normalized price across venues. Null means unavailable; zero remains zero."},"yield":{"type":"number","nullable":true,"description":"Open-interest-weighted annualized yield, percent. Null means unavailable; zero remains zero."},"expiry":{"type":"string","description":"Expiry date, DD/MM/YY."},"symbol":{"type":"string","description":"Base asset and expiry, e.g. BTC-25DEC26."},"volume":{"type":"number","nullable":true,"description":"Total 24-hour USD volume of the expiry across venues. Null means unavailable; zero remains zero."},"markets":{"type":"array","items":{"type":"string"},"description":"Venues listing the expiry; order is unspecified."},"currency":{"type":"string"},"open_interest":{"type":"number","nullable":true,"description":"Total USD open interest of the expiry across venues. Null means unavailable; zero remains zero."},"volume_notional":{"type":"number","nullable":true,"description":"Total 24-hour volume in base-asset units. Null means unavailable; zero remains zero."},"open_interest_volume":{"type":"number","nullable":true,"description":"USD open interest divided by USD 24-hour volume. Null means unavailable; zero remains zero."},"open_interest_notional":{"type":"number","nullable":true,"description":"Total open interest in base-asset units. Null means unavailable; zero remains zero."}},"additionalProperties":false},{"type":"object","required":["markets","ticker","open_interest","open_interest_change_usd","open_interest_notional","open_interest_notional_change"],"properties":{"ticker":{"type":"string","description":"Base asset and expiry, e.g. BTC-25DEC26."},"markets":{"type":"array","items":{"type":"string"},"description":"Venues listing the expiry; order is unspecified."},"open_interest":{"type":"number","nullable":true,"description":"USD open interest at the latest observation. Null means unavailable; zero remains zero."},"open_interest_notional":{"type":"number","nullable":true,"description":"Open interest in base-asset units at the latest observation. Null means unavailable; zero remains zero."},"open_interest_change_usd":{"type":"number","nullable":true,"description":"Latest minus earliest USD open interest within the past hour. Null means unavailable; zero remains zero."},"open_interest_notional_change":{"type":"number","nullable":true,"description":"Latest minus earliest open interest within the past hour, base-asset units. Null means unavailable; zero remains zero."}},"additionalProperties":false},{"type":"object","required":["base_currency"],"properties":{"base_currency":{"type":"string"}},"additionalProperties":false},{"type":"object","required":["symbol","base_currency","market","price","basis","open_interest_coin","expiry","_24h_volume_coin","_24h_volume","bid","ask","bid_amount","ask_amount","index","underlyer"],"properties":{"ask":{"type":"number","nullable":true,"description":"Best ask price. Null means unavailable; zero remains zero."},"bid":{"type":"number","nullable":true,"description":"Best bid price. Null means unavailable; zero remains zero."},"basis":{"type":"number","nullable":true,"description":"Stored basis in the legacy basis convention. Null means unavailable; zero remains zero."},"index":{"type":"number","nullable":true,"description":"Spot index reference. Null means unavailable; zero remains zero."},"price":{"type":"number","nullable":true,"description":"Legacy normalized futures price. Null means unavailable; zero remains zero."},"expiry":{"type":"string"},"market":{"type":"string"},"symbol":{"type":"string"},"underlyer":{"type":"string","nullable":true},"ask_amount":{"type":"number","nullable":true,"description":"Displayed best-ask size. Null means unavailable; zero remains zero."},"bid_amount":{"type":"number","nullable":true,"description":"Displayed best-bid size. Null means unavailable; zero remains zero."},"_24h_volume":{"type":"number","nullable":true,"description":"Rolling 24-hour USD volume. Null means unavailable; zero remains zero."},"base_currency":{"type":"string"},"_24h_volume_coin":{"type":"number","nullable":true,"description":"Rolling 24-hour volume in base-asset units. Null means unavailable; zero remains zero."},"open_interest_coin":{"type":"number","nullable":true,"description":"Open interest in base-asset units. Null means unavailable; zero remains zero."}},"additionalProperties":false},{"type":"object","required":["market","symbol","base_currency","margin","index_price","price","basis","apy","open_interest","open_interest_coin","oi_volume24h","volume24h","volume24h_coin","bid","ask","bid_amount","ask_amount","liquidations","funding","next_funding","long_short_ratio","avg_apr","total_long_usd","total_short_usd","market_cap","realized_vol"],"properties":{"apy":{"type":"number","nullable":true,"description":"Stored annualized yield in percent. For perpetuals this is funding yield; for futures it is annualized carry. Not compounded APY despite the legacy name. Null means unavailable; zero remains zero."},"ask":{"type":"number","nullable":true,"description":"Best ask price at the selected snapshot, not a 24-hour low. Null means unavailable; zero remains zero."},"bid":{"type":"number","nullable":true,"description":"Best bid price at the selected snapshot, not a 24-hour high. Null means unavailable; zero remains zero."},"basis":{"type":"number","nullable":true,"description":"Stored futures/perpetual basis in the legacy source convention; not funding. Null means unavailable; zero remains zero."},"price":{"type":"number","nullable":true,"description":"Legacy normalized derivative price; not an option premium or a historical candle. Null means unavailable; zero remains zero."},"margin":{"type":"string","description":"Legacy margin category: coin or usd; not option call/put."},"market":{"type":"string"},"symbol":{"type":"string","description":"Exact exchange instrument identifier."},"avg_apr":{"type":"object","nullable":true,"description":"Stored average annualized funding yield by lookback days, in percent.","additionalProperties":{"type":"number","nullable":true}},"funding":{"type":"number","nullable":true,"description":"Stored funding rate in percent for the source funding interval; not an annualized rate or universally eight-hour. Null means unavailable; zero remains zero."},"volume24h":{"type":"number","nullable":true,"description":"Stored rolling 24-hour USD volume. Not volume since midnight. Null means unavailable; zero remains zero."},"ask_amount":{"type":"number","nullable":true,"description":"Displayed best-ask size in the legacy source quantity convention; not 24-hour ask volume. Null means unavailable; zero remains zero."},"bid_amount":{"type":"number","nullable":true,"description":"Displayed best-bid size in the legacy source quantity convention; not 24-hour bid volume. Null means unavailable; zero remains zero."},"market_cap":{"type":"number","nullable":true,"description":"Current market capitalization of the base asset, USD. Null means unavailable; zero remains zero."},"index_price":{"type":"number","nullable":true,"description":"Stored index reference, quote/USD units per underlying base unit according to source contract. Null means unavailable; zero remains zero."},"liquidations":{"type":"object","required":["long","short"],"properties":{"long":{"type":"number","nullable":true,"description":"Rolling 24-hour USD amount of long positions liquidated, not buy volume. Null means unavailable; zero remains zero."},"short":{"type":"number","nullable":true,"description":"Rolling 24-hour USD amount of short positions liquidated, not sell volume. Null means unavailable; zero remains zero."}},"additionalProperties":false},"next_funding":{"type":"number","nullable":true,"description":"Next announced funding rate in percent for the source interval. Null means unavailable; zero remains zero."},"oi_volume24h":{"type":"number","nullable":true,"description":"USD open interest divided by rolling 24-hour USD volume; dimensionless, not percent. Null means unavailable; zero remains zero."},"realized_vol":{"type":"object","nullable":true,"description":"Realized volatility of the base asset by lookback days, percent.","additionalProperties":{"type":"number","nullable":true}},"base_currency":{"type":"string","description":"Legacy normalized base asset code."},"open_interest":{"type":"number","nullable":true,"description":"Open interest in USD. Null means unavailable; zero remains zero."},"total_long_usd":{"type":"number","nullable":true,"description":"Rolling 24-hour USD amount of long positions liquidated. Null means unavailable; zero remains zero."},"volume24h_coin":{"type":"number","nullable":true,"description":"Stored rolling 24-hour volume in base-asset units. Null means unavailable; zero remains zero."},"total_short_usd":{"type":"number","nullable":true,"description":"Rolling 24-hour USD amount of short positions liquidated. Null means unavailable; zero remains zero."},"long_short_ratio":{"type":"number","nullable":true,"description":"Stored venue long/short ratio; not a cross-venue standardized metric. Null means unavailable; zero remains zero."},"open_interest_coin":{"type":"number","nullable":true,"description":"Open interest in base-asset units, not USD. Null means unavailable; zero remains zero."}},"additionalProperties":false},{"type":"object","required":["symbol","open_interest","open_interest_coin","open_interest_change_usd","open_interest_notional_change"],"properties":{"symbol":{"type":"string","description":"Exact exchange instrument identifier."},"open_interest":{"type":"number","nullable":true,"description":"USD open interest at the latest observation in the past five minutes. Null means unavailable; zero remains zero."},"open_interest_coin":{"type":"number","nullable":true,"description":"Open interest in base-asset units at that observation. Null means unavailable; zero remains zero."},"open_interest_change_usd":{"type":"number","nullable":true,"description":"Latest minus earliest USD open interest since the lookback start. Null means unavailable; zero remains zero."},"open_interest_notional_change":{"type":"number","nullable":true,"description":"Latest minus earliest open interest since the lookback start, base-asset units. Null means unavailable; zero remains zero."}},"additionalProperties":false},{"type":"object","required":["symbol","base_currency","market","price","funding","next_fr","_24h_volume_coin","_24h_volume","bid","ask","bid_amount","ask_amount","index","underlyer"],"properties":{"ask":{"type":"number","nullable":true,"description":"Best ask price. Null means unavailable; zero remains zero."},"bid":{"type":"number","nullable":true,"description":"Best bid price. Null means unavailable; zero remains zero."},"index":{"type":"number","nullable":true,"description":"Spot index reference. Null means unavailable; zero remains zero."},"price":{"type":"number","nullable":true,"description":"Legacy normalized perpetual price. Null means unavailable; zero remains zero."},"market":{"type":"string"},"symbol":{"type":"string"},"funding":{"type":"number","nullable":true,"description":"Current funding rate in the source convention. Null means unavailable; zero remains zero."},"next_fr":{"type":"number","nullable":true,"description":"Next funding rate where the venue publishes one. Null means unavailable; zero remains zero."},"underlyer":{"type":"string","nullable":true},"ask_amount":{"type":"number","nullable":true,"description":"Displayed best-ask size. Null means unavailable; zero remains zero."},"bid_amount":{"type":"number","nullable":true,"description":"Displayed best-bid size. Null means unavailable; zero remains zero."},"_24h_volume":{"type":"number","nullable":true,"description":"Rolling 24-hour USD volume. Null means unavailable; zero remains zero."},"base_currency":{"type":"string"},"_24h_volume_coin":{"type":"number","nullable":true,"description":"Rolling 24-hour volume in base-asset units. Null means unavailable; zero remains zero."}},"additionalProperties":false},{"type":"object","required":["open_interest","open_interest_change_usd","open_interest_change_usd_percentage","open_interest_notional","open_interest_change_notional","open_interest_change_notional_percentage","markets"],"properties":{"markets":{"type":"array","items":{"type":"string"},"description":"Venues observed at the latest observation; order is unspecified."},"open_interest":{"type":"number","nullable":true,"description":"USD open interest of every venue at the latest observation. Null means unavailable; zero remains zero."},"open_interest_notional":{"type":"number","nullable":true,"description":"Open interest in base-asset units at the latest observation. Null means unavailable; zero remains zero."},"open_interest_change_usd":{"type":"number","nullable":true,"description":"Latest minus earliest USD open interest since the lookback start. Null means unavailable; zero remains zero."},"open_interest_change_notional":{"type":"number","nullable":true,"description":"Latest minus earliest open interest since the lookback start, base-asset units. Null means unavailable; zero remains zero."},"open_interest_change_usd_percentage":{"type":"number","nullable":true,"description":"That change as a percentage of the earliest USD open interest. Null means unavailable; zero remains zero."},"open_interest_change_notional_percentage":{"type":"number","nullable":true,"description":"That change as a percentage of the earliest base-asset open interest. Null means unavailable; zero remains zero."}},"additionalProperties":false}]}},{"type":"object","required":["all","future","perpetual"],"properties":{"all":{"type":"object","required":["usd","notional"],"properties":{"usd":{"type":"object","additionalProperties":{"type":"number","nullable":true}},"notional":{"type":"object","additionalProperties":{"type":"number","nullable":true}}},"additionalProperties":false},"future":{"type":"object","required":["usd","notional"],"properties":{"usd":{"type":"object","additionalProperties":{"type":"number","nullable":true}},"notional":{"type":"object","additionalProperties":{"type":"number","nullable":true}}},"additionalProperties":false},"perpetual":{"type":"object","required":["usd","notional"],"properties":{"usd":{"type":"object","additionalProperties":{"type":"number","nullable":true}},"notional":{"type":"object","additionalProperties":{"type":"number","nullable":true}}},"additionalProperties":false}},"description":"Per-venue USD and base-asset totals: all instruments, dated futures and perpetuals. Venues without a value are omitted.","additionalProperties":false},{"type":"object","description":"Dated futures by base asset, then instrument: mark price, basis, open interest, expiry (08:00 UTC), volume, quotes, references and the response minute.","additionalProperties":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{}}}},{"type":"object","description":"Perpetuals by base asset, then instrument: mark price, funding, next funding, volume, quotes, references and the response minute.","additionalProperties":{"type":"object","additionalProperties":{"type":"object","additionalProperties":{}}}},{"anyOf":[{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","additionalProperties":{}}}},{"type":"array","items":{"not":{}}}],"description":"Perpetuals of one base asset grouped by venue; an empty list when none are observed."},{"type":"array","items":{"type":"string"},"description":"Futures base assets at the latest observation, with legacy scale prefixes and renames resolved."}]},"meta":{"type":"object","required":["dataset","series","generated_at"],"properties":{"series":{"enum":["perpetual_markets","futures_markets","currency_summary","perpetual_funding","futures_yield","market_oi_changes","futures_curve","oi_gainers","price_gainers","top_funding","futures_basis","oi_breakdown","volume_breakdown","futures_summary","futures_oi_change_summary","futures_currencies","futures_snapshot","perpetuals_by_venue","oi_change","perpetuals_snapshot","perpetual_oi_change_summary"],"type":"string"},"dataset":{"enum":["derivatives.current_analytics"],"type":"string"},"generated_at":{"type":"integer","maximum":9007199254740991,"minimum":0,"description":"Response generation time, Unix seconds UTC. Not a source publication timestamp; components can have different observation times."}},"additionalProperties":false}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QO1F72Nn2aUn0eeGCBfmj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time snapshot analytics for crypto derivatives markets including perpetuals, futures, funding rates, OI changes, and market summaries across exchanges.","exampleAgentPrompt":"Pull the current perpetual funding rates for BTC on Binance from Laevitas so I can see which direction the market is leaning and what the average APR looks like across lookback periods.","exampleUseCases":[{"title":"Top funding rate scanner","prompt":"Show me the top funding rates across all perpetual markets right now — I want to see which coins have the most extreme positive or negative funding so I can spot carry trade opportunities."},{"title":"BTC futures curve analysis","prompt":"Get me the current futures curve for BTC across all listed maturities on Binance so I can see where the contango or backwardation is steepest."},{"title":"OI gainers momentum screen","prompt":"Which crypto perpetuals have seen the biggest open interest increases over the last 24 hours? Give me the top gainers so I can spot where new money is flowing in."}],"resultDescription":"Returns a structured object with a meta field and a data array containing market analytics rows. Each row contains fields like symbol, index price, open interest (in USD and coin), 24h volume, bid/ask, funding rate, next funding timestamp, basis, APY, long/short ratio, and average APR by lookback period. The exact fields returned depend on the requested series.","failureModes":["Missing required 'series' field returns validation error","Missing required 'exchange' for series like perpetual_markets or futures_markets returns error","Missing required 'currency' for series like perpetual_funding or futures_curve returns error","Missing required 'hours' for market_oi_changes returns error","Missing required 'period' for oi_gainers or price_gainers returns error","Invalid enum value for series, hours, venue_type, or instrument_type returns 400","Unauthorized or expired API key returns 401; insufficient x402 credits returns payment error","Rate limits or plan restrictions may return 429 or 403"],"whenToPreferThis":"Use this endpoint when you need a real-time snapshot of crypto derivatives market conditions including perpetual funding, futures curves, open interest rankings, and volume breakdowns. It covers a wide range of configurable analytics series in one call, making it ideal for market screeners, carry trade scanners, and derivatives dashboards. Prefer this over historical endpoints when you need the latest market state rather than time-series data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:41:59.206Z","isFirstParty":false,"canonicalSlug":"laevitas-derivatives-current-analytics-699b1e19"}