Perp Gap API
Stock perps & tokenized stocks: trade.xyz, Aster, Lighter, OKX, xStocks, Ondo; quotes, funding. x402
| Endpoint | https://perp-gap-api.perpgap.workers.dev/mcp (streamable-http) |
|---|---|
| Registry version | 1.5.0 |
| Now | 14 tools · grade C (75) · pin ts_312e1a8c96d7ef67be97dc1e2c34fb98 · protocol 2025-06-18 |
| First / last listed | 2026-10-31 02:12 UTC / 2026-10-31 02:12 UTC |
| Grade over time | 2026-10-31: C (75), 14 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: list_markets get_quote get_funding get_token_premium get_token_liquidity get_gap_sample get_gaps get_verdict get_history get_export get_research_card list_pm_markets get_pm_implied get_pm_scan
list_markets | FREE. Catalog of every stock perp and tokenized stock agents can trade: Hyperliquid trade.xyz, Aster, Lighter and OKX perps plus Solana xStocks and Ondo Global Markets tokens. Per market: ticker, venue, symbol / Lighter market_id / Solana mint / Ondo contract, type, live and tradable_now. Use first to see where a ticker trades before get_quote or get_funding. params: ticker, venue, instrument, tradable |
get_quote | PAID $0.01 (x402, USDC on Base or Solana). Unified live quote for 1-10 stock tickers: perp mark and bid/ask mid on trade.xyz, Aster, Lighter and OKX, Solana xStock and Ondo per-share prices, last US close and the reference used (pre/regular/after-hours/overnight/closed), gap % vs reference, perp spread, best bid/ask, cross-venue arb bps, freshness. params: ticker, tickers |
get_funding | PAID $0.02 (x402, USDC on Base or Solana). Stock-perp funding on trade.xyz, Aster, Lighter and OKX normalized to hourly and APR, interval, next funding time, cheapest venue to long or short, carry spread, optional history (24h/7d/30d). tickers='all' returns the board for every stock perp. params: ticker, tickers, history, min_spread_apr |
get_token_premium | PAID $0.01 (x402, USDC on Base or Solana). Tokenized stocks (xStocks on Solana, Ondo Global Markets): each token's price per share vs the real stock reference, premium/discount %, freshness, chain and liquidity. One ticker, up to 10, or tickers='all'. params: ticker, tickers |
get_token_liquidity | PAID $0.01 (x402, USDC on Base or Solana). Tokenized stock liquidity for one ticker: each xStocks/Ondo token's Solana pool liquidity, $10k buy/sell price impact, estimated size within 1%, tradable flag, plus Ondo's issuer mint/redeem market. params: ticker* |
get_gap_sample | FREE. Basic perp-vs-stock gap for ONE trade.xyz stock perp (e.g. NVDA): perp mark, reference stock price, gap %. Use get_gaps for xStock gap, basis, funding and open interest. params: ticker* |
get_gaps | PAID $0.01 (x402, USDC on Base or Solana). Gap table for up to 60 trade.xyz stock perps (tickers=all for every auto-discovered US stock perp): perp mark/oracle vs reference stock price and Solana xStock, basis, hourly and annualized funding, open interest. Set venues='all' for a cross-venue comparison: trade.xyz vs Aster vs Lighter mark prices, gap % between venues, and each venue's funding (hourl params: tickers, venues |
get_verdict | PAID $0.03 (x402, USDC on Base or Solana). Rule-based long/short/watch/avoid verdict for one trade.xyz stock perp, using the perp-vs-stock gap, basis, funding and SEC EDGAR insider and filing signals, with reasons and confidence. Includes a news block (up to 5 items in 48h: SEC 8-K filings, Fed/BLS macro releases, press-wire items as our own one-line summary + link) and a heuristic news_context la params: ticker* |
get_history | PAID $0.02 (x402, USDC on Base or Solana). Historical gap time series for one trade.xyz stock perp (up to 90 days; interval 30m/1h/4h/1d): perp vs stock and xStock gaps, basis, funding, OI, plus Aster, Lighter and OKX marks and cross-venue gaps. params: ticker*, from, to, interval |
get_export | PAID $0.25 (x402, USDC on Base or Solana). Bulk JSON export of one UTC day of 30-minute snapshots for all 20 tracked stock perps (cross-venue gaps, funding, OI). params: date |
get_research_card | PAID $0.03 (x402, USDC on Base or Solana). One-call research card for a single stock perp: spot quote and market session, perp prices on trade.xyz, Aster, Lighter and OKX, gap % per venue vs spot and vs the Solana xStock, funding and basis, recent 72h gap history, and the rule-based verdict. Also xStocks/Ondo token premiums, the extended-hours/overnight trade, the last 4 weekend gaps vs Monday's o params: ticker* |
list_pm_markets | FREE. Live Hyperliquid HIP-4 binary price outcome markets ('BTC above 82,268 at 2026-10-18 08:00 UTC'): outcome id, asset, strike, expiry, settlement source, bid, ask, depth; empty books filtered. Use first to see what get_pm_implied and get_pm_scan cover. Data, not advice. params: asset, kind |
get_pm_implied | PAID $0.02 (x402, USDC on Base or Solana). Is a Hyperliquid prediction market on a crypto or stock price cheap or expensive? For every live binary price outcome on one asset: bid, ask, depth, the probability implied by the live perp price and 7d realized vol, edge in pp vs bid and ask, liquidity flag and signal. Bad input or no live market is a free error. Data, not advice. params: asset, outcome, min_depth_usd |
get_pm_scan | PAID $0.05 (x402, USDC on Base or Solana). Ranked list of the most mispriced liquid Hyperliquid prediction markets right now across crypto and tokenized-stock binary price markets: model probability vs bid/ask, edge in pp, spread, depth and book age; empty and illiquid books filtered. Data, not advice. params: min_edge_pp, max_spread_pp, min_depth_usd, limit, kind |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.