Perp Gap API
Stock-perp gaps, verdicts and Hyperliquid prediction-market odds vs perp-implied probability. x402.
我该使用它吗
质量与安全性
发现(1)
- LOW在 get_history 中
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高,可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中:
{
"mcpServers": {
"perp-gap": {
"url": "https://perp-gap-api.perpgap.workers.dev/mcp"
}
}
}远程端点
https://perp-gap-api.perpgap.workers.dev/mcpstreamable-http它能做什么
工具清单
工具(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.
输入模式
{
"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).
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"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).
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"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.
输入模式
{
"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#"
}社区
证据