Skip to content

Perp Gap API

by perp-gap-api.perpgap.workers.dev · remote · no sign-in to list tools · v1.4.0 · published by dev.workers.perpgap.perp-gap-api

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

Read only

14 tools: 14 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http perp-gap https://perp-gap-api.perpgap.workers.dev/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

14 tools

Only reads 14Claude Code: allow
  • get_exportPAID $0.25 (x402, USDC on Base or Solana).No findings

    Why it is in this group

    • The name "get_export" says "get": a word for reading.
    Description, as the server wrote it
    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).
  • get_fundingPAID $0.02 (x402, USDC on Base or Solana).No findings

    Why it is in this group

    • The name "get_funding" says "get": a word for reading.
    Description, as the server wrote it
    PAID $0.02 (x402, USDC on Base or Solana). Stock-perp funding on trade.xyz, Aster and Lighter 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.
  • get_gap_sampleFREE.No findings

    Why it is in this group

    • The name "get_gap_sample" says "get": a word for reading.
    Description, as the server wrote it
    FREE. Basic perp-vs-stock gap for ONE trade.xyz stock perp (e.g. TSLA): perp mark, reference stock price, gap %. Use get_gaps for xStock gap, basis, funding and open interest.
  • get_gapsPAID $0.01 (x402, USDC on Base or Solana).No findings

    Why it is in this group

    • The name "get_gaps" says "get": a word for reading.
    Description, as the server wrote it
    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).
  • get_historyPAID $0.02 (x402, USDC on Base or Solana).No findings

    Why it is in this group

    • The name "get_history" says "get": a word for reading.
    Description, as the server wrote it
    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 and Lighter marks and cross-venue gaps.
  • get_pm_impliedPAID $0.02 (x402, USDC on Base or Solana).No findings

    Why it is in this group

    • The name "get_pm_implied" says "get": a word for reading.
    Description, as the server wrote it
    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.
  • get_pm_scanPAID $0.05 (x402, USDC on Base or Solana).No findings

    Why it is in this group

    • The name "get_pm_scan" says "get": a word for reading.
    Description, as the server wrote it
    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.
  • get_quotePAID $0.01 (x402, USDC on Base or Solana).No findings

    Why it is in this group

    • The name "get_quote" says "get": a word for reading.
    Description, as the server wrote it
    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 and Lighter, 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.
  • get_research_cardPAID $0.03 (x402, USDC on Base or Solana).No findings

    Why it is in this group

    • The name "get_research_card" says "get": a word for reading.
    Description, as the server wrote it
    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 and Lighter, 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.
  • get_token_liquidityPAID $0.01 (x402, USDC on Base or Solana).No findings

    Why it is in this group

    • The name "get_token_liquidity" says "get": a word for reading.
    Description, as the server wrote it
    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.
  • get_token_premiumPAID $0.01 (x402, USDC on Base or Solana).No findings

    Why it is in this group

    • The name "get_token_premium" says "get": a word for reading.
    Description, as the server wrote it
    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'.
  • get_verdictPAID $0.03 (x402, USDC on Base or Solana).No findings

    Why it is in this group

    • The name "get_verdict" says "get": a word for reading.
    Description, as the server wrote it
    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.
  • list_marketsFREE.No findings

    Why it is in this group

    • The name "list_markets" says "list": a word for reading.
    Description, as the server wrote it
    FREE. Catalog of every stock perp and tokenized stock agents can trade: Hyperliquid trade.xyz, Aster and Lighter 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.
  • list_pm_marketsFREE.No findings

    Why it is in this group

    • The name "list_pm_markets" says "list": a word for reading.
    Description, as the server wrote it
    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.

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.4.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http perp-gap https://perp-gap-api.perpgap.workers.dev/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__perp-gap__list_markets",
      "mcp__perp-gap__get_quote",
      "mcp__perp-gap__get_funding",
      "mcp__perp-gap__get_token_premium",
      "mcp__perp-gap__get_token_liquidity",
      "mcp__perp-gap__get_gap_sample",
      "mcp__perp-gap__get_gaps",
      "mcp__perp-gap__get_verdict",
      "mcp__perp-gap__get_history",
      "mcp__perp-gap__get_export",
      "mcp__perp-gap__get_research_card",
      "mcp__perp-gap__list_pm_markets",
      "mcp__perp-gap__get_pm_implied",
      "mcp__perp-gap__get_pm_scan"
    ],
    "ask": [],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as perp-gap. Review it before you use it.