{"openapi":"3.1.0","info":{"title":"Perp Derivatives Signals","version":"1.0.0","description":"Crypto perpetual futures funding, open interest, basis, liquidity and crowding signals from Hyperliquid's public market data. One call, one computed answer, no accounts or API keys. Machine-payable over x402.","x-guidance":"Perp Derivatives Signals answers one question per call about a crypto perpetual future listed on Hyperliquid: is funding crowded, how wide is the cross-venue funding gap, how deep is the book, how volatile is it. Each paid GET returns a computed verdict (such as CROWDED_LONG, NEUTRAL or THIN) with the reasons, the source and what was NOT checked, not raw data. Pass coin as the Hyperliquid ticker, for example BTC or ETH. A verdict of UNVERIFIED means a lookup failed: treat it as unknown, never as clean. NOT_LISTED means the coin is not a live Hyperliquid perp. Rates are shown hourly and annualized. Market signals only, not trading advice. No account or key: pay per call in USDC over x402."},"servers":[{"url":"https://derivatives.x402tookit.com"}],"paths":{"/funding-extremes":{"get":{"operationId":"funding_extremes","summary":"Most extreme perp funding right now across Hyperliquid, filtered by open interest. Top crowded longs and shorts.","description":"Most extreme perp funding right now across Hyperliquid, filtered by open interest. Top crowded longs and shorts.","tags":["perps","funding-rate","scanner"],"parameters":[{"name":"n","in":"query","required":false,"description":"How many per side, 1 to 10, default 5","schema":{"type":"integer"}},{"name":"min_oi_usd","in":"query","required":false,"description":"Ignore coins with open interest below this, default 1000000","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"scanned":{"type":["null","number"]},"minOpenInterestUsd":{"type":["null","number"]},"topCrowdedLongs":{"type":["array","null"],"items":{"type":"object","properties":{"coin":{"type":["null","string"]},"fundingAnnualizedPct":{"type":["null","number"]},"openInterestUsd":{"type":["null","number"]},"volume24hUsd":{"type":["null","number"]}}}},"topCrowdedShorts":{"type":["array","null"],"items":{"type":"object","properties":{"coin":{"type":["null","string"]},"fundingAnnualizedPct":{"type":["null","number"]},"openInterestUsd":{"type":["null","number"]},"volume24hUsd":{"type":["null","number"]}}}},"thresholds":{"type":["null","object"],"properties":{"fundingElevatedAnnualizedPct":{"type":["null","number"]},"fundingCrowdedAnnualizedPct":{"type":["null","number"]}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"EXTREMES_FOUND","summary":"124 coins scanned with open interest of at least $1,000,000; largest absolute funding is 376.3% annualized.","reasons":["Largest |funding| 376.3% vs crowded threshold 60%."],"scanned":124,"minOpenInterestUsd":1000000,"topCrowdedLongs":[{"coin":"AZTEC","fundingAnnualizedPct":94.67,"openInterestUsd":1898801,"volume24hUsd":946915},{"coin":"XMR","fundingAnnualizedPct":53.93,"openInterestUsd":66227035,"volume24hUsd":8954007}],"topCrowdedShorts":[{"coin":"MINA","fundingAnnualizedPct":-376.3,"openInterestUsd":1803311,"volume24hUsd":2546467},{"coin":"TRX","fundingAnnualizedPct":-29.01,"openInterestUsd":14212511,"volume24hUsd":1604725}],"thresholds":{"fundingElevatedAnnualizedPct":25,"fundingCrowdedAnnualizedPct":60},"degraded":false,"notChecked":["venues other than Hyperliquid","why funding is extreme"],"source":"Hyperliquid metaAndAssetCtxs","sourceUrl":"https://api.hyperliquid.xyz/info","asOf":"2026-10-11T01:05:05.946Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/funding-extremes"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/funding-extremes"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/funding-extremes"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/funding-extremes"}}]}}},"/funding-history":{"get":{"operationId":"funding_history","summary":"Funding persistence for a perp over the last 6-168 hours: average, sign streaks, and how unusual now is.","description":"Funding persistence for a perp over the last 6-168 hours: average, sign streaks, and how unusual now is.","tags":["perps","funding-rate","history"],"parameters":[{"name":"coin","in":"query","required":true,"description":"Hyperliquid ticker, e.g. BTC","schema":{"type":"string"}},{"name":"hours","in":"query","required":false,"description":"Lookback hours, 6 to 168, default 72","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"coin":{"type":["null","string"]},"hours":{"type":["null","number"]},"points":{"type":["null","number"]},"meanAnnualizedPct":{"type":["null","number"]},"latestAnnualizedPct":{"type":["null","number"]},"zScoreOfLatest":{"type":["null","number"]},"shareOfPositivePrints":{"type":["null","number"]},"longestSameSignRunHours":{"type":["null","number"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"UNUSUAL_NOW","summary":"BTC funding was positive in 78% of the last 72 hourly prints; average 5.06% annualized, latest -10.95% (z -2.9).","reasons":["Longest same-sign run: 33 hours.","The latest print is more than 2 standard deviations from this window's mean."],"coin":"BTC","hours":72,"points":72,"meanAnnualizedPct":5.06,"latestAnnualizedPct":-10.95,"zScoreOfLatest":-2.9,"shareOfPositivePrints":0.778,"longestSameSignRunHours":33,"degraded":false,"notChecked":["longer history than the window","other venues"],"source":"Hyperliquid fundingHistory","sourceUrl":"https://api.hyperliquid.xyz/info","asOf":"2026-10-11T01:05:06.409Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/funding-history"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/funding-history"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/funding-history"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/funding-history"}}]}}},"/funding-spread":{"get":{"operationId":"funding_spread","summary":"Cross-venue funding gap for a perp: Hyperliquid vs Binance vs Bybit, normalized per hour and annualized.","description":"Cross-venue funding gap for a perp: Hyperliquid vs Binance vs Bybit, normalized per hour and annualized.","tags":["perps","funding-rate","arbitrage"],"parameters":[{"name":"coin","in":"query","required":true,"description":"Ticker, e.g. BTC, ETH, SOL","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"coin":{"type":["null","string"]},"spreadAnnualizedPoints":{"type":["null","number"]},"lowest":{"type":["null","string"]},"highest":{"type":["null","string"]},"venues":{"type":["array","null"],"items":{"type":"object","properties":{"venue":{"type":["null","string"]},"intervalHours":{"type":["null","number"]},"ratePerInterval":{"type":["null","number"]},"annualizedPct":{"type":["null","number"]},"nextFundingTime":{"type":["null","number"]}}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"MODERATE_SPREAD","summary":"ETH funding differs by 13.14 annualized points across 3 venues: lowest HlPerp (-18.9%), highest BybitPerp (-5.76%).","reasons":["Gap 13.14 points; thresholds: moderate at 8, wide at 20."],"coin":"ETH","spreadAnnualizedPoints":13.14,"lowest":"HlPerp","highest":"BybitPerp","venues":[{"venue":"BinPerp","intervalHours":8,"ratePerInterval":-0.00011485,"annualizedPct":-12.58,"nextFundingTime":1791705600000},{"venue":"HlPerp","intervalHours":1,"ratePerInterval":-0.0000215747,"annualizedPct":-18.9,"nextFundingTime":1791680400000}],"degraded":false,"notChecked":["trading fees, borrow cost, transfer time and position limits that decide whether a gap is capturable","venues outside the feed"],"source":"Hyperliquid predictedFundings (reports Hyperliquid, Binance and Bybit)","sourceUrl":"https://api.hyperliquid.xyz/info","asOf":"2026-10-11T01:05:06.878Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/funding-spread"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/funding-spread"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/funding-spread"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/funding-spread"}}]}}},"/open-interest":{"get":{"operationId":"open_interest","summary":"Perp open interest in USD, OI-to-volume ratio and rank on Hyperliquid. Flags leveraged build-up.","description":"Perp open interest in USD, OI-to-volume ratio and rank on Hyperliquid. Flags leveraged build-up.","tags":["perps","open-interest","crypto"],"parameters":[{"name":"coin","in":"query","required":true,"description":"Hyperliquid ticker, e.g. BTC, SOL","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"coin":{"type":["null","string"]},"openInterestUsd":{"type":["null","number"]},"openInterestCoins":{"type":["null","number"]},"volume24hUsd":{"type":["null","number"]},"oiToVolumeRatio":{"type":["null","number"]},"rankByOpenInterest":{"type":["null","number"]},"ofContracts":{"type":["null","number"]},"thresholds":{"type":["null","object"],"properties":{"highRatio":{"type":["null","number"]},"normalRatio":{"type":["null","number"]}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"OI_HIGH","summary":"SOL open interest is $634,318,535, 9.402x its 24h volume, rank 4 of 178 on Hyperliquid.","reasons":["Open interest exceeds a full day of volume: positions are being held, not just traded."],"coin":"SOL","openInterestUsd":634318535,"openInterestCoins":5769154.48,"volume24hUsd":67463882,"oiToVolumeRatio":9.402,"rankByOpenInterest":4,"ofContracts":178,"thresholds":{"highRatio":1,"normalRatio":0.3},"degraded":false,"notChecked":["who holds the interest or on which side","other venues"],"source":"Hyperliquid metaAndAssetCtxs","sourceUrl":"https://api.hyperliquid.xyz/info","asOf":"2026-10-11T01:05:07.138Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/open-interest"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/open-interest"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/open-interest"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/open-interest"}}]}}},"/perp-basis":{"get":{"operationId":"perp_basis","summary":"Perp premium to oracle price for a coin on Hyperliquid, in percent, with a stretched/normal verdict.","description":"Perp premium to oracle price for a coin on Hyperliquid, in percent, with a stretched/normal verdict.","tags":["perps","basis","premium"],"parameters":[{"name":"coin","in":"query","required":true,"description":"Hyperliquid ticker, e.g. BTC, ETH","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"coin":{"type":["null","string"]},"markPx":{"type":["null","number"]},"oraclePx":{"type":["null","number"]},"midPx":{"type":["null","number"]},"markVsOraclePct":{"type":["null","number"]},"venuePremium":{"type":["null","number"]},"thresholds":{"type":["null","object"],"properties":{"stretchedPct":{"type":["null","number"]}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"NORMAL","summary":"BTC mark price is -0.067% below the oracle price.","reasons":["Threshold for stretched is 0.5% either way."],"coin":"BTC","markPx":82906,"oraclePx":82961.6,"midPx":82898.5,"markVsOraclePct":-0.067,"venuePremium":-0.000754566,"thresholds":{"stretchedPct":0.5},"degraded":false,"notChecked":["spot exchange prices","whether the gap will close"],"source":"Hyperliquid metaAndAssetCtxs","sourceUrl":"https://api.hyperliquid.xyz/info","asOf":"2026-10-11T01:05:07.402Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-basis"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-basis"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-basis"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-basis"}}]}}},"/perp-funding":{"get":{"operationId":"perp_funding","summary":"Is perp funding crowded? Current Hyperliquid funding for a coin, annualized, with a crowded long/short verdict.","description":"Is perp funding crowded? Current Hyperliquid funding for a coin, annualized, with a crowded long/short verdict.","tags":["perps","funding-rate","crypto"],"parameters":[{"name":"coin","in":"query","required":true,"description":"Hyperliquid ticker, e.g. BTC, ETH, SOL","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"coin":{"type":["null","string"]},"fundingPerHour":{"type":["null","number"]},"fundingAnnualizedPct":{"type":["null","number"]},"premium":{"type":["null","number"]},"otherVenues":{"type":["array","null"],"items":{"type":"object","properties":{"venue":{"type":["null","string"]},"intervalHours":{"type":["null","number"]},"ratePerInterval":{"type":["null","number"]},"annualizedPct":{"type":["null","number"]}}}},"thresholds":{"type":["null","object"],"properties":{"fundingElevatedAnnualizedPct":{"type":["null","number"]},"fundingCrowdedAnnualizedPct":{"type":["null","number"]}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"NEUTRAL","summary":"BTC funding on Hyperliquid is -18.67% annualized (neutral).","reasons":["Funding is -18.67% annualized, inside the neutral band."],"coin":"BTC","fundingPerHour":-0.0000213099,"fundingAnnualizedPct":-18.67,"premium":-0.000754566,"otherVenues":[{"venue":"BinPerp","intervalHours":8,"ratePerInterval":-0.00003926,"annualizedPct":-4.3},{"venue":"HlPerp","intervalHours":1,"ratePerInterval":-0.0000207953,"annualizedPct":-18.22}],"thresholds":{"fundingElevatedAnnualizedPct":25,"fundingCrowdedAnnualizedPct":60},"degraded":false,"notChecked":["funding on venues other than Hyperliquid except as reported in predictedFundings","whether funding will persist","…1 more"],"source":"Hyperliquid metaAndAssetCtxs + predictedFundings","sourceUrl":"https://api.hyperliquid.xyz/info","asOf":"2026-10-11T01:05:07.662Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-funding"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-funding"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-funding"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-funding"}}]}}},"/perp-liquidity":{"get":{"operationId":"perp_liquidity","summary":"Perp order-book depth and market-order slippage for $10k and $100k on Hyperliquid, with a thin/deep verdict.","description":"Perp order-book depth and market-order slippage for $10k and $100k on Hyperliquid, with a thin/deep verdict.","tags":["perps","liquidity","slippage"],"parameters":[{"name":"coin","in":"query","required":true,"description":"Hyperliquid ticker, e.g. ETH","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"coin":{"type":["null","string"]},"mid":{"type":["null","number"]},"spreadBps":{"type":["null","number"]},"depthWithin0_5PctUsd":{"type":["null","object"],"properties":{"bids":{"type":["null","number"]},"asks":{"type":["null","number"]}}},"slippage":{"type":["array","null"],"items":{"type":"object","properties":{"sizeUsd":{"type":["null","number"]},"buyBps":{"type":["null","number"]},"sellBps":{"type":["null","number"]}}}},"thresholds":{"type":["null","object"],"properties":{"thinOverBps":{"type":["null","number"]},"moderateOverBps":{"type":["null","number"]}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"DEEP","summary":"ETH spread 0.4 bps; a $100k market order slips 0.54 bps worst side.","reasons":["Slippage is measured against mid on the top 20 book levels per side (all the venue returns)."],"coin":"ETH","mid":2503.85,"spreadBps":0.4,"depthWithin0_5PctUsd":{"bids":18511391,"asks":15209977},"slippage":[{"sizeUsd":10000,"buyBps":0.2,"sellBps":0.2},{"sizeUsd":100000,"buyBps":0.54,"sellBps":0.2}],"thresholds":{"thinOverBps":25,"moderateOverBps":5},"degraded":false,"notChecked":["liquidity beyond the top 20 levels","other venues","…1 more"],"source":"Hyperliquid l2Book","sourceUrl":"https://api.hyperliquid.xyz/info","asOf":"2026-10-11T01:05:08.124Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-liquidity"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-liquidity"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-liquidity"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-liquidity"}}]}}},"/perp-listing":{"get":{"operationId":"perp_listing","summary":"Is a coin a live Hyperliquid perp? Listed, delisted or isolated-only, with max leverage and size precision.","description":"Is a coin a live Hyperliquid perp? Listed, delisted or isolated-only, with max leverage and size precision.","tags":["perps","listing","crypto"],"parameters":[{"name":"coin","in":"query","required":true,"description":"Ticker to check, e.g. PEPE, kPEPE, BTC","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"coin":{"type":["null","string"]},"maxLeverage":{"type":["null","number"]},"sizeDecimals":{"type":["null","number"]},"isDelisted":{"type":["boolean","null"]},"onlyIsolated":{"type":["boolean","null"]},"marginTableId":{"type":["null","number"]},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"LISTED","summary":"BTC is listed on Hyperliquid with max leverage 40x.","reasons":["Active contract with cross margin available."],"coin":"BTC","maxLeverage":40,"sizeDecimals":5,"isDelisted":false,"onlyIsolated":false,"marginTableId":56,"degraded":false,"notChecked":["spot listings","other venues","…1 more"],"source":"Hyperliquid metaAndAssetCtxs","sourceUrl":"https://api.hyperliquid.xyz/info","asOf":"2026-10-11T01:05:08.383Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-listing"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-listing"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-listing"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-listing"}}]}}},"/perp-snapshot":{"get":{"operationId":"perp_snapshot","summary":"One-call perp snapshot on Hyperliquid: price, 24h move, funding, open interest, volume and max leverage with flags.","description":"One-call perp snapshot on Hyperliquid: price, 24h move, funding, open interest, volume and max leverage with flags.","tags":["perps","crypto","market-data"],"parameters":[{"name":"coin","in":"query","required":true,"description":"Hyperliquid ticker, e.g. BTC","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"coin":{"type":["null","string"]},"markPx":{"type":["null","number"]},"oraclePx":{"type":["null","number"]},"change24hPct":{"type":["null","number"]},"fundingAnnualizedPct":{"type":["null","number"]},"openInterestUsd":{"type":["null","number"]},"volume24hUsd":{"type":["null","number"]},"maxLeverage":{"type":["null","number"]},"flags":{"type":["array","null"]},"thresholds":{"type":["null","object"],"properties":{"fundingElevatedAnnualizedPct":{"type":["null","number"]},"fundingCrowdedAnnualizedPct":{"type":["null","number"]}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"NO_FLAGS","summary":"BTC: mark 82906, 24h 0.33%, funding -18.67% annualized, open interest $3,171,886,172.","reasons":["No funding, move or margin flags."],"coin":"BTC","markPx":82906,"oraclePx":82961.6,"change24hPct":0.33,"fundingAnnualizedPct":-18.67,"openInterestUsd":3171886172,"volume24hUsd":801438677,"maxLeverage":40,"flags":[],"thresholds":{"fundingElevatedAnnualizedPct":25,"fundingCrowdedAnnualizedPct":60},"degraded":false,"notChecked":["order book depth (see /perp-liquidity)","other venues","…1 more"],"source":"Hyperliquid metaAndAssetCtxs","sourceUrl":"https://api.hyperliquid.xyz/info","asOf":"2026-10-11T01:05:08.648Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-snapshot"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-snapshot"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-snapshot"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-snapshot"}}]}}},"/perp-volatility":{"get":{"operationId":"perp_volatility","summary":"Realized volatility for a perp from hourly candles over 24-168 hours, annualized, with a high/low verdict.","description":"Realized volatility for a perp from hourly candles over 24-168 hours, annualized, with a high/low verdict.","tags":["perps","volatility","crypto"],"parameters":[{"name":"coin","in":"query","required":true,"description":"Hyperliquid ticker, e.g. SOL","schema":{"type":"string"}},{"name":"hours","in":"query","required":false,"description":"Lookback hours, 24 to 168, default 72","schema":{"type":"integer"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"coin":{"type":["null","string"]},"hours":{"type":["null","number"]},"candles":{"type":["null","number"]},"realizedVolAnnualizedPct":{"type":["null","number"]},"rangePct":{"type":["null","number"]},"maxHourlyMovePct":{"type":["null","number"]},"thresholds":{"type":["null","object"],"properties":{"highAnnualizedPct":{"type":["null","number"]},"moderateAnnualizedPct":{"type":["null","number"]}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"VOL_MODERATE","summary":"SOL realized volatility is 62.1% annualized over 73 hourly candles; range 10.51%.","reasons":["Largest single-hour move 3.56%."],"coin":"SOL","hours":72,"candles":73,"realizedVolAnnualizedPct":62.1,"rangePct":10.51,"maxHourlyMovePct":3.56,"thresholds":{"highAnnualizedPct":100,"moderateAnnualizedPct":50},"degraded":false,"notChecked":["implied volatility","volatility outside the window","…1 more"],"source":"Hyperliquid candleSnapshot (1h)","sourceUrl":"https://api.hyperliquid.xyz/info","asOf":"2026-10-11T01:05:09.143Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-volatility"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-volatility"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-volatility"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/perp-volatility"}}]}}},"/squeeze-watch":{"get":{"operationId":"squeeze_watch","summary":"Squeeze risk for a perp: funding, open interest build-up, 24h move and basis combined into a published points score.","description":"Squeeze risk for a perp: funding, open interest build-up, 24h move and basis combined into a published points score.","tags":["perps","squeeze","risk"],"parameters":[{"name":"coin","in":"query","required":true,"description":"Hyperliquid ticker, e.g. SOL","schema":{"type":"string"}}],"responses":{"200":{"description":"The answer.","content":{"application/json":{"schema":{"type":"object","properties":{"verdict":{"type":["null","string"]},"summary":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"coin":{"type":["null","string"]},"longSqueezePoints":{"type":["null","number"]},"shortSqueezePoints":{"type":["null","number"]},"inputs":{"type":["null","object"],"properties":{"fundingAnnualizedPct":{"type":["null","number"]},"oiToVolumeRatio":{"type":["null","number"]},"change24hPct":{"type":["null","number"]},"markVsOraclePct":{"type":["null","number"]}}},"degraded":{"type":["boolean","null"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"source":{"type":["null","string"]},"sourceUrl":{"type":["null","string"]},"asOf":{"type":["null","string"]},"disclaimer":{"type":["null","string"]}}},"example":{"verdict":"NO_SQUEEZE_SIGNAL","summary":"SOL squeeze score: long 1, short 0 (3 or more triggers a flag).","reasons":["open interest >= 1x daily volume: +1 on the crowded side"],"coin":"SOL","longSqueezePoints":1,"shortSqueezePoints":0,"inputs":{"fundingAnnualizedPct":10.95,"oiToVolumeRatio":9.402,"change24hPct":0.28,"markVsOraclePct":-0.032},"degraded":false,"notChecked":["order book depth","liquidation levels (not public here)","…2 more"],"source":"Hyperliquid metaAndAssetCtxs","sourceUrl":"https://api.hyperliquid.xyz/info","asOf":"2026-10-11T01:05:09.403Z","disclaimer":"Screening signal computed from the named public source. Not financial, legal or investment advice; provided as is. Verify at the source before acting."}}}},"400":{"description":"A parameter was missing or out of range."},"402":{"description":"Payment Required"},"502":{"description":"The upstream source failed or timed out."}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.0200"},"protocols":[{"x402":{"network":"eip155:8453","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/squeeze-watch"}},{"x402":{"network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/squeeze-watch"}},{"x402":{"network":"eip155:137","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/squeeze-watch"}},{"x402":{"network":"eip155:42161","scheme":"exact","currency":"USDC","endpoint":"https://derivatives.x402tookit.com/squeeze-watch"}}]}}}}}