{"slug":"perp-gap-api-perpgap-workers-dev-gaps-5c495f","title":"Gap table for trade.xyz (Hyperliquid HIP-3) stock perps","host":"perp-gap-api.perpgap.workers.dev","method":"GET","resource":"https://perp-gap-api.perpgap.workers.dev/gaps","category":"market","description":"Gap table for trade.xyz (Hyperliquid HIP-3) stock perps: perp mark/oracle vs live stock price and Solana xStock, basis, hourly and annualized funding, open interest; venues=all adds Aster and Lighter marks, funding and cross-venue spreads. Use when an agent needs current premium/discount or funding ","price_listed":0.01,"price_asked":0.01,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":497,"reported_calls_30d":8,"reported_payers_30d":3,"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"tickers":"TSLA,NVDA,GME","venues":"all"},"type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"method":{"enum":["GET"],"type":"string"},"queryParams":{"additionalProperties":false,"properties":{"tickers":{"description":"Optional. Comma-separated tickers or \"all\" (auto-discovered US stock perps; see free GET /tickers), max 60 per call (highest OI kept). Default: 20 large names. Unknown tickers are skipped.","examples":["TSLA,NVDA,GME","all"],"type":"string"},"venues":{"description":"Optional. 'all' adds per-ticker cross-venue comparison: trade.xyz vs Aster vs Lighter marks, gaps and funding (hourly + annualized). Omit for trade.xyz only.","enum":["all"],"examples":["all"],"type":"string"}},"required":[],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"description":"Error responses are JSON {error: string}: 402 payment required; 502 upstream data error.","properties":{"count":{"type":"integer"},"dex":{"type":"string"},"disclaimer":{"type":"string"},"generated_at":{"type":"integer"},"rows":{"items":{"properties":{"basis_mark_vs_oracle_pct":{"type":["number","null"]},"flags":{"items":{"type":"string"},"type":"array"},"funding_annualized_pct":{"type":["number","null"]},"funding_hourly":{"type":["number","null"]},"gap_perp_vs_ref_pct":{"type":["number","null"]},"gap_perp_vs_xstock_pct":{"type":["number","null"]},"market_session":{"enum":["pre-market","regular","after-hours","overnight","closed"],"type":"string"},"open_interest":{"type":["number","null"]},"open_interest_usd":{"type":["number","null"]},"perp_mark":{"type":["number","null"]},"perp_oracle":{"type":["number","null"]},"perp_ts":{"type":"integer"},"ref_age_seconds":{"type":["integer","null"]},"ref_price":{"type":["number","null"]},"ref_session":{"type":["string","null"]},"ref_source":{"description":"yahoo, alpaca-overnight (bid_ask_mid|last_trade) or robinhood-24h fallback (overnight)","type":["string","null"]},"ref_ts":{"type":["integer","null"]},"ticker":{"type":"string"},"venues":{"description":"Only with venues=all. xyz/aster/lighter objects {mark,index,funding_hourly,funding_annualized_pct,volume_24h_usd,open_interest_usd} or null, plus gap_aster_vs_xyz_pct, gap_lighter_vs_xyz_pct, gap_lighter_vs_aster_pct, gap_aster_vs_ref_pct, gap_lighter_vs_ref_pct, max_mark_spread_pct, richest, cheapest, funding_spread_annualized_pct.","type":"object"},"xstock_price":{"type":["number","null"]}},"required":["ticker","perp_mark"],"type":"object"},"type":"array"}},"required":["rows"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-18","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.01,"price_match":true,"latency_ms":497,"error":null}],"description_full":"Gap table for trade.xyz (Hyperliquid HIP-3) stock perps: perp mark/oracle vs live stock price and Solana xStock, basis, hourly and annualized funding, open interest; venues=all adds Aster and Lighter marks, funding and cross-venue spreads. Use when an agent needs current premium/discount or funding arbitrage signals across many tokenized stocks at once (cheapest call). Errors: 402 payment required, 502 upstream error.","last_updated":"2026-10-17T03:17:44.343Z","schemes":["exact"]}