Servers Playground How we check Add a server Log in

Perp Gap API

Working · 725 ms

dev.workers.perpgap.perp-gap-api/perp-gapv1.4.0 Domain verified

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

Finance & Payments Crypto & Web3

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://perp-gap-api.perpgap.workers.dev/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

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

datestring

UTC day YYYY-MM-DD, default yesterday

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Perp Gap API MCP server | mcptry

Tools (14)

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

Argument	Type	Description
date	string	UTC day YYYY-MM-DD, default yesterday

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "date": {
      "type": "string",
      "description": "UTC day YYYY-MM-DD, default yesterday"
    }
  },
  "additionalProperties": false
}

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.

Argument	Type	Description
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

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "One ticker, e.g. NVDA"
    },
    "history": {
      "enum": [
        "24h",
        "7d",
        "30d"
      ],
      "type": "string",
      "description": "History window (single ticker)"
    },
    "tickers": {
      "enum": [
        "all"
      ],
      "type": "string",
      "description": "'all' for the full board"
    },
    "min_spread_apr": {
      "type": "number",
      "description": "Board: minimum APR spread between venues"
    }
  },
  "additionalProperties": false
}

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.

Argument	Type	Description
ticker*	string	One ticker, e.g. NVDA

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "ticker"
  ],
  "properties": {
    "ticker": {
      "type": "string",
      "description": "One ticker, e.g. NVDA"
    }
  },
  "additionalProperties": false
}

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

Argument	Type	Description
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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "venues": {
      "enum": [
        "all"
      ],
      "type": "string",
      "description": "'all' adds the trade.xyz vs Aster vs Lighter comparison"
    },
    "tickers": {
      "type": "string",
      "description": "Comma-separated tickers or 'all', max 60 per call, e.g. NVDA or NVDA,TSLA. Defaults to 20 large names."
    }
  },
  "additionalProperties": false
}

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.

Argument	Type	Description
to	string	ISO end (UTC), default now
from	string	ISO start (UTC), default 7 days ago
ticker*	string	One ticker, e.g. NVDA
interval	string	Default 1h

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "ticker"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "ISO end (UTC), default now"
    },
    "from": {
      "type": "string",
      "description": "ISO start (UTC), default 7 days ago"
    },
    "ticker": {
      "type": "string",
      "description": "One ticker, e.g. NVDA"
    },
    "interval": {
      "enum": [
        "30m",
        "1h",
        "4h",
        "1d"
      ],
      "type": "string",
      "description": "Default 1h"
    }
  },
  "additionalProperties": false
}

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.

Argument	Type	Description
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

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "asset": {
      "type": "string",
      "description": "Underlying perp, e.g. BTC, ETH, HYPE, SP500, META (default BTC)"
    },
    "outcome": {
      "type": "integer",
      "description": "Optional Hyperliquid outcome id"
    },
    "min_depth_usd": {
      "type": "number",
      "description": "Hide markets with less USDC within 5 pp of the touch on either side; default 0"
    }
  },
  "additionalProperties": false
}

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.

Argument	Type	Description
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

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "kind": {
      "enum": [
        "crypto",
        "stocks",
        "all"
      ],
      "type": "string",
      "description": "Default all"
    },
    "limit": {
      "type": "integer",
      "description": "1-50, default 20"
    },
    "min_edge_pp": {
      "type": "number",
      "description": "Default 2"
    },
    "max_spread_pp": {
      "type": "number",
      "description": "Default 10"
    },
    "min_depth_usd": {
      "type": "number",
      "description": "Both sides; default 50"
    }
  },
  "additionalProperties": false
}

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.

Argument	Type	Description
ticker	string	One ticker, e.g. NVDA
tickers	string	Up to 10 comma-separated tickers instead of ticker

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "One ticker, e.g. NVDA"
    },
    "tickers": {
      "type": "string",
      "description": "Up to 10 comma-separated tickers instead of ticker"
    }
  },
  "additionalProperties": false
}

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.

Argument	Type	Description
ticker*	string	One ticker, e.g. NVDA

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "ticker"
  ],
  "properties": {
    "ticker": {
      "type": "string",
      "description": "One ticker, e.g. NVDA"
    }
  },
  "additionalProperties": false
}

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.

Argument	Type	Description
ticker*	string	One ticker, e.g. NVDA

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "ticker"
  ],
  "properties": {
    "ticker": {
      "type": "string",
      "description": "One ticker, e.g. NVDA"
    }
  },
  "additionalProperties": false
}

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

Argument	Type	Description
ticker	string	One ticker, e.g. NVDA
tickers	string	Up to 10 comma-separated tickers, or 'all'

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "ticker": {
      "type": "string",
      "description": "One ticker, e.g. NVDA"
    },
    "tickers": {
      "type": "string",
      "description": "Up to 10 comma-separated tickers, or 'all'"
    }
  },
  "additionalProperties": false
}

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.

Argument	Type	Description
ticker*	string	One ticker, e.g. NVDA

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "ticker"
  ],
  "properties": {
    "ticker": {
      "type": "string",
      "description": "One ticker, e.g. NVDA"
    }
  },
  "additionalProperties": false
}

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.

Argument	Type	Description
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

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "venue": {
      "type": "string",
      "description": "Comma-separated: hyperliquid-xyz, aster, lighter, xstocks-solana, ondo-gm"
    },
    "ticker": {
      "type": "string",
      "description": "Comma-separated tickers, e.g. NVDA or NVDA,TSLA. Recommended: without it you get 2,000+ rows."
    },
    "tradable": {
      "type": "boolean",
      "description": "Only markets accepting orders now"
    },
    "instrument": {
      "enum": [
        "perp",
        "token"
      ],
      "type": "string",
      "description": "perp or token"
    }
  },
  "additionalProperties": false
}

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.

Argument	Type	Description
kind	string	Default all
asset	string	Optional underlying, e.g. BTC, ETH, HYPE, SP500, XYZ100, META

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "kind": {
      "enum": [
        "crypto",
        "stocks",
        "all"
      ],
      "type": "string",
      "description": "Default all"
    },
    "asset": {
      "type": "string",
      "description": "Optional underlying, e.g. BTC, ETH, HYPE, SP500, XYZ100, META"
    }
  },
  "additionalProperties": false
}