Perp Gap API

Use first to see which venues list a ticker and get the exact symbol before /quote, /funding or /gaps. Every stock perp and tokenized stock agents can trade: trade.xyz, Aster, Lighter and OKX perps plus xStocks and Ondo tokens (2,400+ markets), with venue, symbol or mint, underlying, type, live and tradable-now flags. Same data free at GET /catalog. Errors: 400 unknown venue, 402, 502. Data, not advice.

Use when an agent needs current premium/discount or funding signals across many stock perps in one cheap call. trade.xyz (Hyperliquid HIP-3) perp mark/oracle vs the live stock price and Solana xStock, basis, hourly and annualized funding, open interest; venues=all adds Aster, Lighter and OKX marks, funding and cross-venue spreads. Errors: 402, 502. Data, not advice.

Use when an agent needs to backtest or chart how a stock perp's premium/discount and funding evolved, including weekends and holidays when the stock is shut. One ticker: trade.xyz perp mark/oracle vs stock and xStock, basis, funding, OI, Aster/Lighter/OKX cross-venue gaps; 30-minute snapshots plus ~60d backfill, up to 90 days per call. Bad params return 400/404 before any charge. Errors: 400, 402, 404, 502. Data, not advice.

Use when an agent needs the best live price for a stock across venues before trading. For 1-10 tickers: perp mark and mid on trade.xyz (Hyperliquid), Aster, Lighter and OKX, xStocks and Ondo token prices per share, last US close, the session reference price, gap % vs it, cross-venue spread, best bid/ask and freshness. Unpaid calls get 402; bad or unknown tickers get 400/404 before any charge. Errors: 400, 402, 404, 502. Data, not advice.

Use before sizing a tokenized-stock trade or choosing between xStocks and Ondo for execution. For one ticker: each token's Solana pool liquidity, price impact of a $10k buy and sell, rough size executable within 1%, a tradable flag, and Ondo's issuer mint/redeem market. Bad params return 400/404 before any charge. Errors: 400, 402, 404, 502. Data, not advice.

Use before buying or pricing a tokenized stock (NVDAx, NVDAon) to see if it trades rich or cheap vs the real share. For one ticker, up to 10, or tickers=all: each xStocks and Ondo Global Markets token's price per share vs the stock reference, premium %, Ondo issuer price, freshness, chain and pool liquidity. Bad params return 400/404 before any charge. Errors: 400, 402, 404, 502. Data, not advice.

Use when an agent must pick the cheapest venue to hold a stock perp or size funding carry. Funding on trade.xyz, Aster, Lighter and OKX normalized to hourly and annualized APR, interval and next funding time, cheapest venue to be long or short, carry spread, optional 24h/7d/30d history; one ticker or tickers=all. Bad params return 400/404 before any charge. Errors: 400, 402, 404, 502. Data, not advice.

Use when an agent must decide if a Hyperliquid prediction market on a crypto or stock price (e.g. 'BTC above 82k on Oct 19', 'SP500 above 7730') is cheap or expensive. Returns each live outcome's bid, ask and depth, the probability implied by the live perp price and 7d realized vol, edge in pp vs bid and ask, and a liquidity flag. Empty books are filtered. Errors: 400 bad input, 404 no live market (both free, never charged), 402, 502. Data, not advice.

Use when an agent wants the most mispriced liquid Hyperliquid prediction markets right now in one call. Ranks crypto and tokenized-stock binary price markets by edge: model probability from the live perp and 7d realized vol vs bid/ask, edge in pp, spread, depth and book age; empty and illiquid books are filtered. 400/404 are free, never charged. Errors: 400, 402, 404, 502. Data, not advice.

One-call research card for a single stock perp: spot quote and US session (pre/regular/after-hours/overnight/closed), perp prices on trade.xyz, Aster and Lighter, gap % vs spot and vs Solana xStock, funding, basis, last 72h gap history and the rule-based long/short/watch/avoid verdict. Use when an agent needs everything about one ticker before trading or answering a user. Data, not advice. Errors: 400 missing ticker, 402, 404 not listed, 502 upstream.

Rule-based long/short/watch/avoid verdict with score, confidence and reasons for one trade.xyz stock perp, combining perp-vs-stock gap, basis, funding, SEC EDGAR insider/8-K/13D/dilution filings (14d), news and retail attention. Use when an agent needs a quick directional signal or a sanity check on a single ticker before trading. Data, not financial advice. Errors: 400 missing ticker, 402 payment required, 404 not listed, 502 upstream.

Bulk export of one UTC day of live 30-minute snapshots for all tracked stock perps (top 40 auto-discovered tickers by open interest × up to 48 snapshots): trade.xyz vs stock vs xStock gaps, basis, funding, OI, plus Aster and Lighter marks, funding and cross-venue gaps. JSON or CSV.