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 a

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,

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. Erro

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 needs a quick directional sanity check on one stock perp before trading. Long/short/watch/avoid with score, confidence and reasons, combining perp-vs-stock gap, basis, funding, SEC EDGAR insider/8-K/13D/dilution filings (14d), news and retail attention. Bad or unlisted tickers return 400/404 before any charge. Errors: 400, 402, 404, 502. Data, not advice.

Use when an agent needs everything about one US stock in one call before trading or answering a user. Stock quote incl. extended/overnight trade, perp prices on trade.xyz, Aster, Lighter, OKX, xStocks/Ondo token prices, gaps, funding, last 4 weekend gaps vs Monday open, 72h history, rule-based verdict and plain-text summary. No LLM. Bad or unlisted tickers return 400/404 before any charge. Errors:

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

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 ad

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.

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.