Perp Gap API
Stock-perp gaps, verdicts and Hyperliquid prediction-market odds vs perp-implied probability. x402.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (1)
- LOWin get_history
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"perp-gap": {
"url": "https://perp-gap-api.perpgap.workers.dev/mcp"
}
}
}Remote-Endpunkte
https://perp-gap-api.perpgap.workers.dev/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (9)
🟢get_gap_sample(ticker)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "One ticker, e.g. TSLA"
}
},
"required": [
"ticker"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡get_gaps(tickers, venues)
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).
Eingabe-Schema
{
"type": "object",
"properties": {
"tickers": {
"type": "string",
"description": "Comma-separated tickers or 'all', max 60 per call, e.g. TSLA,NVDA,GME. Defaults to 20 large names."
},
"venues": {
"type": "string",
"enum": [
"all"
],
"description": "'all' adds the trade.xyz vs Aster vs Lighter comparison"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_verdict(ticker)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "One ticker, e.g. GME"
}
},
"required": [
"ticker"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_history(ticker, from, to, interval)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "One ticker, e.g. TSLA"
},
"from": {
"type": "string",
"description": "ISO start (UTC), default 7 days ago"
},
"to": {
"type": "string",
"description": "ISO end (UTC), default now"
},
"interval": {
"type": "string",
"enum": [
"30m",
"1h",
"4h",
"1d"
],
"description": "Default 1h"
}
},
"required": [
"ticker"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_export(date)
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).
Eingabe-Schema
{
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "UTC day YYYY-MM-DD, default yesterday"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_research_card(ticker)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"ticker": {
"type": "string",
"description": "One ticker, e.g. TSLA"
}
},
"required": [
"ticker"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_pm_markets(asset, kind)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"asset": {
"type": "string",
"description": "Optional underlying, e.g. BTC, ETH, HYPE, SP500, XYZ100, META"
},
"kind": {
"type": "string",
"enum": [
"crypto",
"stocks",
"all"
],
"description": "Default all"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_pm_implied(asset, outcome, min_depth_usd)
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.
Eingabe-Schema
{
"type": "object",
"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,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_pm_scan(min_edge_pp, max_spread_pp, min_depth_usd, limit, kind)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"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"
},
"limit": {
"type": "integer",
"description": "1-50, default 20"
},
"kind": {
"type": "string",
"enum": [
"crypto",
"stocks",
"all"
],
"description": "Default all"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Nachweis