derivatives_snapshot

Crypto derivatives snapshot of one coin in one call: perp funding rates per exchange with predicted funding, open interest (OI) per venue, perp premium and the nearest futures basis, 24h liquidations and the long/short ratio. Venues: Bybit, Hyperliquid, dYdX, Gate, Kraken, Bitfinex, Deribit, OKX. The derivatives data bundle for trading agents on BTC, ETH, SOL and more. Data only. Bad input is free; under 3 venues not charged. Price: $0.005 per successful call, paid over x402 (USDC on Base); pass the payment in _meta["x402/payment"].

read-only

Argument	Type	Description
coin*	string	Coin symbol: BTC, ETH, SOL, PEPE ... (also BTCUSDT, BTC-PERP, XBT, 1000PEPE, kPEPE).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "maxLength": 32,
      "minLength": 1,
      "description": "Coin symbol: BTC, ETH, SOL, PEPE ... (also BTCUSDT, BTC-PERP, XBT, 1000PEPE, kPEPE)."
    }
  }
}

funding_arbitrage_scan

Funding arbitrage scanner across 8 exchanges (Bybit, Hyperliquid, dYdX, Gate, Kraken, Bitfinex, Deribit, OKX): for every coin the widest cross-venue perp funding spread, the long and short venue, both funding rates, gross and fee-adjusted net APR and breakeven days, with a 24h volume liquidity filter. Funding rate arbitrage, basis trade and carry screening of perpetual swaps. Data only, no advice. Bad input is free; under 3 venues not charged. Price: $0.005 per successful call, paid over x402 (USDC on Base); pass the payment in _meta["x402/payment"].

read-only

Argument	Type	Description
limit	integer	Opportunities returned, 1-100. Default 20.
fee_pct	number	Taker fee per fill, percent of notional (4 fills). Default 0.05.
min_apr	number	Minimum gross spread in APR percent. Default 10.
holding_days	integer	Holding period used to amortise fees in net_apr_pct. Default 30.
min_volume_usd	number	Both legs need at least this 24 h volume (USD). Default 0.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Opportunities returned, 1-100. Default 20."
    },
    "fee_pct": {
      "type": "number",
      "maximum": 1,
      "minimum": 0,
      "description": "Taker fee per fill, percent of notional (4 fills). Default 0.05."
    },
    "min_apr": {
      "type": "number",
      "maximum": 10000,
      "minimum": 0,
      "description": "Minimum gross spread in APR percent. Default 10."
    },
    "holding_days": {
      "type": "integer",
      "maximum": 365,
      "minimum": 1,
      "description": "Holding period used to amortise fees in net_apr_pct. Default 30."
    },
    "min_volume_usd": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": 0,
      "description": "Both legs need at least this 24 h volume (USD). Default 0."
    }
  }
}

funding_rate_history

Funding rate history of one coin on one exchange (Bybit, Hyperliquid, dYdX, Gate, Kraken, Deribit or OKX), up to 30 days: every past funding print with interval, 8h rate and APR, plus avg/min/max/% positive and the window covered. Historical perpetual swap funding for backtests and carry studies on BTC, ETH, SOL and more. Data only. Bad input is free; a venue that fails is not charged. Price: $0.003 per successful call, paid over x402 (USDC on Base); pass the payment in _meta["x402/payment"].

read-only

Argument	Type	Description
coin*	string	Coin symbol: BTC, ETH, SOL, PEPE ... (also BTCUSDT, BTC-PERP, XBT, 1000PEPE, kPEPE).
days	integer	Days back, 1-30. Default 7.
venue*	string	The exchange whose funding history to return.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin",
    "venue"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "maxLength": 32,
      "minLength": 1,
      "description": "Coin symbol: BTC, ETH, SOL, PEPE ... (also BTCUSDT, BTC-PERP, XBT, 1000PEPE, kPEPE)."
    },
    "days": {
      "type": "integer",
      "maximum": 30,
      "minimum": 1,
      "description": "Days back, 1-30. Default 7."
    },
    "venue": {
      "enum": [
        "bybit",
        "hyperliquid",
        "dydx",
        "gate",
        "kraken",
        "deribit",
        "okx"
      ],
      "type": "string",
      "description": "The exchange whose funding history to return."
    }
  }
}

futures_basis

Futures basis and term structure of one coin: dated futures on Bybit, Deribit, Kraken, Gate and OKX with days to expiry, basis vs index and annualised basis (contango or backwardation, the carry), the perp premium (mark vs index/oracle) on Hyperliquid, dYdX, Bitfinex and the others, and predicted funding. Crypto futures basis for BTC, ETH and more. Data only. Bad input is free; under 2 venues not charged. Price: $0.003 per successful call, paid over x402 (USDC on Base); pass the payment in _meta["x402/payment"].

read-only

Argument	Type	Description
coin*	string	Coin symbol: BTC, ETH, SOL, PEPE ... (also BTCUSDT, BTC-PERP, XBT, 1000PEPE, kPEPE).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "maxLength": 32,
      "minLength": 1,
      "description": "Coin symbol: BTC, ETH, SOL, PEPE ... (also BTCUSDT, BTC-PERP, XBT, 1000PEPE, kPEPE)."
    }
  }
}

implied_volatility

Implied volatility (IV) of crypto options per expiry from Deribit, Bybit and OKX: ATM IV, 25-delta skew, put/call open interest ratio, max pain and Deribit's DVOL index; with an expiry, the options chain per strike with the greeks as each venue publishes them. Volatility surface inputs for BTC and ETH options. Data only. Bad input is free; nothing is charged when no venue answers. Price: $0.003 per successful call, paid over x402 (USDC on Base); pass the payment in _meta["x402/payment"].

read-only

Argument	Type	Description
coin*	string	Coin symbol: BTC, ETH, SOL, PEPE ... (also BTCUSDT, BTC-PERP, XBT, 1000PEPE, kPEPE).
expiry	string	Optional expiry date YYYY-MM-DD (UTC): that expiry plus its chain with the venues' greeks.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "maxLength": 32,
      "minLength": 1,
      "description": "Coin symbol: BTC, ETH, SOL, PEPE ... (also BTCUSDT, BTC-PERP, XBT, 1000PEPE, kPEPE)."
    },
    "expiry": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Optional expiry date YYYY-MM-DD (UTC): that expiry plus its chain with the venues' greeks."
    }
  }
}

liquidations

Liquidations of one coin's perpetual futures: recent forced liquidations from the Gate, Bitfinex, dYdX, Deribit and OKX public feeds, long and short liquidations in USD per venue, the totals and the largest events over 1-24h. Liquidation data for BTC, ETH, SOL and more; Bybit, Hyperliquid and Kraken are listed as not covered (WebSocket only). Data only. Bad input is free; under 2 feeds not charged. Price: $0.003 per successful call, paid over x402 (USDC on Base); pass the payment in _meta["x402/payment"].

read-only

Argument	Type	Description
coin*	string	Coin symbol: BTC, ETH, SOL, PEPE ... (also BTCUSDT, BTC-PERP, XBT, 1000PEPE, kPEPE).
hours	integer	Look-back window in hours, 1-24. Default 24.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "maxLength": 32,
      "minLength": 1,
      "description": "Coin symbol: BTC, ETH, SOL, PEPE ... (also BTCUSDT, BTC-PERP, XBT, 1000PEPE, kPEPE)."
    },
    "hours": {
      "type": "integer",
      "maximum": 24,
      "minimum": 1,
      "description": "Look-back window in hours, 1-24. Default 24."
    }
  }
}

open_interest

Open interest (OI) of one coin's perpetual futures by exchange: Bybit, Hyperliquid, dYdX, Gate, Kraken, Bitfinex, Deribit, OKX. Per venue OI in coins and USD and its share, the total, and the OI change over 1h, 4h and 24h from the venues' own history. Perp open interest and futures open interest for BTC, ETH, SOL and more. Data only. Bad input is free; under 2 venues (3 for a coin listed on 3+) not charged. Price: $0.003 per successful call, paid over x402 (USDC on Base); pass the payment in _meta["x402/payment"].

read-only

Argument	Type	Description
coin*	string	Coin symbol: BTC, ETH, SOL, PEPE ... (also BTCUSDT, BTC-PERP, XBT, 1000PEPE, kPEPE).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "maxLength": 32,
      "minLength": 1,
      "description": "Coin symbol: BTC, ETH, SOL, PEPE ... (also BTCUSDT, BTC-PERP, XBT, 1000PEPE, kPEPE)."
    }
  }
}

order_book_depth

Order book depth of one coin's perpetual on Bybit, Hyperliquid, dYdX, Gate, Kraken, Bitfinex, Deribit and OKX: best bid/ask, spread in bps, market depth in USD within 0.1/0.5/1/2% of mid, bid/ask imbalance, estimated slippage for your order size and the largest resting orders (walls). L2 orderbook liquidity for BTC, ETH, SOL and more. Data only. Bad input is free; under 2 venues not charged. Price: $0.003 per successful call, paid over x402 (USDC on Base); pass the payment in _meta["x402/payment"].

read-only

Argument	Type	Description
coin*	string	Coin symbol: BTC, ETH, SOL, PEPE ... (also BTCUSDT, BTC-PERP, XBT, 1000PEPE, kPEPE).
levels	integer	Also return the top N levels per side (0-20). Default 0.
size_usd	number	Order size in USD for the slippage estimate. Default 100000.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "maxLength": 32,
      "minLength": 1,
      "description": "Coin symbol: BTC, ETH, SOL, PEPE ... (also BTCUSDT, BTC-PERP, XBT, 1000PEPE, kPEPE)."
    },
    "levels": {
      "type": "integer",
      "maximum": 20,
      "minimum": 0,
      "description": "Also return the top N levels per side (0-20). Default 0."
    },
    "size_usd": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 1,
      "description": "Order size in USD for the slippage estimate. Default 100000."
    }
  }
}

perp_funding_rates

Funding rates for perpetual futures (perp funding) of one coin across 8 exchanges: Bybit, Hyperliquid, dYdX, Gate, Kraken, Bitfinex, Deribit, OKX. Per venue the current funding rate, interval, 8h rate, APR, next funding time, mark and index; predicted funding incl. Binance and Bybit (via Hyperliquid); the last 24 hourly prints with avg/min/max/% positive. Perpetual swap funding for BTC, ETH, SOL and more. Data only. Bad input is free; under 3 venues not charged. Price: $0.003 per successful call, paid over x402 (USDC on Base); pass the payment in _meta["x402/payment"].

read-only

Argument	Type	Description
coin*	string	Coin symbol: BTC, ETH, SOL, PEPE ... (also BTCUSDT, BTC-PERP, XBT, 1000PEPE, kPEPE).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "maxLength": 32,
      "minLength": 1,
      "description": "Coin symbol: BTC, ETH, SOL, PEPE ... (also BTCUSDT, BTC-PERP, XBT, 1000PEPE, kPEPE)."
    }
  }
}

perp_screener

Perp screener for all coins: every perpetual future on Bybit, Hyperliquid, dYdX, Gate, Kraken, Bitfinex, Deribit and OKX in one call, sorted by funding rate (APR), open interest (OI), 24h volume or 24h change, with the highest and lowest funding views. A funding screener and perpetuals market ranking for BTC, ETH, SOL and hundreds of altcoins. Data only. Bad input is free; under 3 venues not charged. Price: $0.005 per successful call, paid over x402 (USDC on Base); pass the payment in _meta["x402/payment"].

read-only

Argument	Type	Description
sort	string	funding \| oi \| volume \| change. Default funding.
limit	integer	Coins returned, 1-200. Default 50.
order	string	Default desc.
min_volume_usd	number	Minimum total 24 h volume (USD). Default 0.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "sort": {
      "enum": [
        "funding",
        "oi",
        "volume",
        "change"
      ],
      "type": "string",
      "description": "funding | oi | volume | change. Default funding."
    },
    "limit": {
      "type": "integer",
      "maximum": 200,
      "minimum": 1,
      "description": "Coins returned, 1-200. Default 50."
    },
    "order": {
      "enum": [
        "desc",
        "asc"
      ],
      "type": "string",
      "description": "Default desc."
    },
    "min_volume_usd": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": 0,
      "description": "Minimum total 24 h volume (USD). Default 0."
    }
  }
}

Crypto Derivatives Data: Perp Funding Rates, Open Interest, Basis, IV

Try it

derivatives_snapshot Read-only

Crypto Derivatives Data: Perp Funding Rates, Open Interest, Basis, IV

Try it

derivatives_snapshot Read-only

Tools (10)