Perp Gap API

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Stock-perp gaps, verdicts and Hyperliquid prediction-market odds vs perp-implied probability. x402.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Perp Gap API": {
      "url": "https://perp-gap-api.perpgap.workers.dev/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (14)

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

  Parameters:

  • venue — string — Comma-separated: hyperliquid-xyz, aster, lighter, xstocks-solana, ondo-gm
  • ticker — string — Comma-separated tickers, e.g. NVDA or NVDA,TSLA. Recommended: without it you get 2,000+ rows.
  • tradable — boolean — Only markets accepting orders now
  • instrument — string — perp or token

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Parameters:

  • ticker — string — One ticker, e.g. NVDA
  • tickers — string — Up to 10 comma-separated tickers instead of ticker

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Parameters:

  • ticker — string — One ticker, e.g. NVDA
  • history — string — History window (single ticker)
  • tickers — string — 'all' for the full board
  • min_spread_apr — number — Board: minimum APR spread between venues

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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'.

  Parameters:

  • ticker — string — One ticker, e.g. NVDA
  • tickers — string — Up to 10 comma-separated tickers, or 'all'

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Parameters:

  • ticker (required) — string — One ticker, e.g. NVDA

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Parameters:

  • ticker (required) — string — One ticker, e.g. NVDA

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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 (hourly and annualized).

  Parameters:

  • venues — string — 'all' adds the trade.xyz vs Aster vs Lighter comparison
  • tickers — string — Comma-separated tickers or 'all', max 60 per call, e.g. NVDA or NVDA,TSLA. Defaults to 20 large names.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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 label (likely news-driven / news present, move small / possibly macro-driven / no matching news). Data, not financial advice.

  Parameters:

  • ticker (required) — string — One ticker, e.g. NVDA

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Parameters:

  • ticker (required) — string — One ticker, e.g. NVDA
  • to — string — ISO end (UTC), default now
  • from — string — ISO start (UTC), default 7 days ago
  • interval — string — Default 1h

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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).

  Parameters:

  • date — string — UTC day YYYY-MM-DD, default yesterday

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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. 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 label (likely news-driven / news present, move small / possibly macro-driven / no matching news). Data, not financial advice.

  Parameters:

  • ticker (required) — string — One ticker, e.g. NVDA

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Parameters:

  • kind — string — Default all
  • asset — string — Optional underlying, e.g. BTC, ETH, HYPE, SP500, XYZ100, META

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Parameters:

  • asset — string — Underlying perp, e.g. BTC, ETH, HYPE, SP500, META (default BTC)
  • outcome — integer — Optional Hyperliquid outcome id
  • min_depth_usd — number — Hide markets with less USDC within 5 pp of the touch on either side; default 0

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Parameters:

  • kind — string — Default all
  • limit — integer — 1-50, default 20
  • min_edge_pp — number — Default 2
  • max_spread_pp — number — Default 10
  • min_depth_usd — number — Both sides; default 50

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.