Perp Gap API
Use when an agent wants a ranked list of the most mispriced liquid prediction markets on Hyperliquid right now, across all crypto and tokenized-stock binary price markets, in one call. Each row has model probability vs bid/ask, edge in pp, spread, depth and book age; empty and illiquid books are filtered out. For scanners, trading agents and daily briefings. Errors: 400 bad params, 404 no books (free, never charged), 402, 502. Data, not advice.
InferenceLiveeip155:8453Exactvia cdp
TradingDataPrediction MarketsSignalsPrediction-market-scanner
Calls · 30d
1
This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 13 snapshots so far.
$0.78
Verified settled volume
42 settlements proven x402 by their on-chain EIP-3009 marker.
$0.050
Listed price
As published in the catalog. Always read the live 402 before paying.
1
Calls · 30d
Upstream's own call count for this endpoint, not ours.
1
Unique payers · 30d
Last called 2026-10-17 13:17Z
—
Upstream on-chain volume
Reported by the source catalog.
Paid to
0x2d82dcB9cC3a168d9Ab25b62C1E33E278A51254FThe wallet the 402 directs payment to. Its whole payment record — every payer, every chain — is on the merchant page.
Asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Provider
The payTo wallet does not resolve to a registered ERC-8004 agent. That is not a verdict on the service — most of the catalog is unregistered.
Accepts
The payment requirements as published to the catalog. Read the live 402 before paying — a price here is a claim, not a quote.
0.05USDC≈ $0.05 USD
on Base · exact scheme
Pay 0.05 USDC on Base to 0x2d82…1254F. The signed payment is good for 2 minutes.
- Paid to
- 0x2d82…1254F
- USD Coin contract
- 0x8335…02913
- Payment window
- 2 minutes
- As published
- 50000 smallest units
50000units
on solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · exact scheme
That figure is in the token’s smallest units. Roundhouse does not hold this contract’s decimals, so it is shown as published rather than converted.
- Paid to
- 5MoL8H…LrEja
- Token contract
- EPjFWd…TDt1v
- Payment window
- 2 minutes
The catalog’s raw entry
[
{
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x2d82dcB9cC3a168d9Ab25b62C1E33E278A51254F",
"amount": "50000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 120
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "D6ZhtNQ5nT9ZnTHUbqXZsTx5MH2rPFiBBggX4hY1WePM"
},
"payTo": "5MoL8HNnvZUogGrqiF4T1StmAUpdU7ERA2GUJ7gLrEja",
"amount": "50000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 120
}
]Extensions
{
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"min_edge_pp": "2",
"max_spread_pp": "10"
}
},
"output": {
"type": "json",
"example": {
"rows": [
{
"ask": 0.3658,
"bid": 0.2534,
"mid": 0.3096,
"kind": "stocks",
"perp": "xyz:SP500",
"asset": "SP500",
"expiry": "2026-10-23T20:00:00Z",
"liquid": true,
"signal": "yes_overpriced",
"strike": 7740,
"book_ts": "2026-10-17T13:10:43Z",
"outcome": 13371,
"ask_size": 186,
"bid_size": 180,
"question": "SP500 above 7740 at 2026-10-23 20:00:00 UTC",
"spot_mid": 7653.45,
"depth_usd": {
"ask": 175.07,
"bid": 107.23,
"levels": 5,
"window_pp": 5
},
"spread_pp": 11.2,
"book_age_s": 55,
"model_prob": 0.2102,
"settlement": {
"side": "Yes pays 1 USDC if the price is above the strike at expiry",
"source": "the Pyth US500 index price",
"window_seconds": 90
},
"best_edge_pp": 4.3,
"edge_vs_ask_pp": -15.6,
"edge_vs_bid_pp": 4.3,
"hours_to_expiry": 150.81,
"realized_vol_7d": 0.1073
}
],
"count": 1,
"label": "data, not advice",
"method": "P(S_T > K) under a lognormal model with zero drift, S = live Hyperliquid perp mid, sigma = 7-day realized vol from Hyperliquid 1h candles (annualized x sqrt(8760)). No options data. Edges use executable bid/ask, never mid.",
"source": "Hyperliquid info API (outcomeMeta, l2Book, allMids, candleSnapshot)",
"filters": {
"kind": "all",
"limit": 20,
"min_edge_pp": 2,
"max_spread_pp": 12,
"min_depth_usd": 50
},
"matched": 1,
"scanned": 110,
"spot_live": true,
"disclaimer": "Data, not financial advice. Not an offer or solicitation; Hyperliquid outcome markets are not available to US or other excluded persons.",
"generated_at_iso": "2026-10-17T13:11:39Z",
"cache_updated_iso": "2026-10-17T13:10:56Z",
"median_book_age_s": 77,
"filtered_out_illiquid": 27,
"filtered_out_empty_books": 73
}
}
},
"schema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"input"
],
"properties": {
"input": {
"type": "object",
"required": [
"type",
"method"
],
"properties": {
"type": {
"type": "string",
"const": "http"
},
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"type": "object",
"required": [],
"properties": {
"kind": {
"enum": [
"crypto",
"stocks",
"all"
],
"type": "string",
"default": "all",
"examples": [
"all"
],
"description": "Optional: crypto (BTC, ETH, HYPE, ZEC), stocks (trade.xyz stock, index and commodity perps) or all."
},
"limit": {
"type": "string",
"default": "20",
"pattern": "^\\d{1,2}$",
"examples": [
"10"
],
"description": "Optional max rows, 1-50. Default 20."
},
"min_edge_pp": {
"type": "string",
"default": "2",
"pattern": "^-?\\d+(\\.\\d+)?$",
"examples": [
"3"
],
"description": "Optional minimum edge in percentage points (model vs executable bid/ask). Default 2."
},
"max_spread_pp": {
"type": "string",
"default": "10",
"pattern": "^\\d+(\\.\\d+)?$",
"examples": [
"10"
],
"description": "Optional maximum bid-ask spread in percentage points. Default 10."
},
"min_depth_usd": {
"type": "string",
"default": "50",
"pattern": "^\\d+(\\.\\d+)?$",
"examples": [
"100"
],
"description": "Optional minimum USDC depth within 5 pp of the touch on BOTH sides. Default 50."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"required": [
"rows",
"scanned",
"label",
"disclaimer"
],
"properties": {
"note": {
"type": "string"
},
"rows": {
"type": "array",
"items": {
"type": "object",
"required": [
"outcome",
"asset",
"strike",
"expiry",
"bid",
"ask",
"depth_usd",
"liquid"
],
"properties": {
"ask": {
"type": "number",
"description": "Best Yes ask (probability, 0-1)"
},
"bid": {
"type": "number",
"description": "Best Yes bid (probability, 0-1)"
},
"mid": {
"type": "number"
},
"kind": {
"enum": [
"crypto",
"stocks"
],
"type": "string"
},
"perp": {
"type": "string",
"description": "Underlying Hyperliquid perp, e.g. BTC or xyz:META"
},
"asset": {
"type": "string"
},
"expiry": {
"type": "string",
"format": "date-time"
},
"liquid": {
"type": "boolean",
"description": "spread <= 10 pp (scan: max_spread_pp) and >= $50 depth on both sides (scan: min_depth_usd)"
},
"signal": {
"enum": [
"yes_underpriced",
"yes_overpriced",
"fair",
"illiquid",
"no_model"
],
"type": "string"
},
"strike": {
"type": "number"
},
"book_ts": {
"type": "string",
"format": "date-time"
},
"outcome": {
"type": "integer",
"description": "Hyperliquid outcome id (Yes token = coin #<id>0)"
},
"ask_size": {
"type": "number"
},
"bid_size": {
"type": "number"
},
"question": {
"type": "string"
},
"spot_mid": {
"type": [
"number",
"null"
]
},
"depth_usd": {
"type": "object",
"properties": {
"ask": {
"type": "number"
},
"bid": {
"type": "number"
},
"levels": {
"type": "integer"
},
"window_pp": {
"type": "number"
}
},
"description": "USDC notional resting within window_pp of the touch, top 5 levels"
},
"spread_pp": {
"type": "number"
},
"book_age_s": {
"type": "integer"
},
"model_prob": {
"type": [
"number",
"null"
],
"description": "Model P(price > strike at expiry), 0-1"
},
"settlement": {
"type": "object",
"properties": {
"side": {
"type": "string"
},
"source": {
"type": [
"string",
"null"
]
},
"window_seconds": {
"type": [
"number",
"null"
]
}
}
},
"best_edge_pp": {
"type": [
"number",
"null"
]
},
"edge_vs_ask_pp": {
"type": [
"number",
"null"
],
"description": "(model_prob - ask) x 100: > 0 means you could buy Yes below model value"
},
"edge_vs_bid_pp": {
"type": [
"number",
"null"
],
"description": "(bid - model_prob) x 100: > 0 means you could sell Yes above model value"
},
"hours_to_expiry": {
"type": "number"
},
"realized_vol_7d": {
"type": [
"number",
"null"
]
}
}
}
},
"count": {
"type": "integer"
},
"label": {
"type": "string",
"const": "data, not advice"
},
"method": {
"type": "string"
},
"source": {
"type": "string"
},
"closest": {
"type": "array",
"items": {
"type": "object",
"required": [
"outcome",
"asset",
"strike",
"expiry",
"bid",
"ask",
"depth_usd",
"liquid"
],
"properties": {
"ask": {
"type": "number",
"description": "Best Yes ask (probability, 0-1)"
},
"bid": {
"type": "number",
"description": "Best Yes bid (probability, 0-1)"
},
"mid": {
"type": "number"
},
"kind": {
"enum": [
"crypto",
"stocks"
],
"type": "string"
},
"perp": {
"type": "string",
"description": "Underlying Hyperliquid perp, e.g. BTC or xyz:META"
},
"asset": {
"type": "string"
},
"expiry": {
"type": "string",
"format": "date-time"
},
"liquid": {
"type": "boolean",
"description": "spread <= 10 pp (scan: max_spread_pp) and >= $50 depth on both sides (scan: min_depth_usd)"
},
"signal": {
"enum": [
"yes_underpriced",
"yes_overpriced",
"fair",
"illiquid",
"no_model"
],
"type": "string"
},
"strike": {
"type": "number"
},
"book_ts": {
"type": "string",
"format": "date-time"
},
"outcome": {
"type": "integer",
"description": "Hyperliquid outcome id (Yes token = coin #<id>0)"
},
"ask_size": {
"type": "number"
},
"bid_size": {
"type": "number"
},
"question": {
"type": "string"
},
"spot_mid": {
"type": [
"number",
"null"
]
},
"depth_usd": {
"type": "object",
"properties": {
"ask": {
"type": "number"
},
"bid": {
"type": "number"
},
"levels": {
"type": "integer"
},
"window_pp": {
"type": "number"
}
},
"description": "USDC notional resting within window_pp of the touch, top 5 levels"
},
"spread_pp": {
"type": "number"
},
"book_age_s": {
"type": "integer"
},
"model_prob": {
"type": [
"number",
"null"
],
"description": "Model P(price > strike at expiry), 0-1"
},
"settlement": {
"type": "object",
"properties": {
"side": {
"type": "string"
},
"source": {
"type": [
"string",
"null"
]
},
"window_seconds": {
"type": [
"number",
"null"
]
}
}
},
"best_edge_pp": {
"type": [
"number",
"null"
]
},
"edge_vs_ask_pp": {
"type": [
"number",
"null"
],
"description": "(model_prob - ask) x 100: > 0 means you could buy Yes below model value"
},
"edge_vs_bid_pp": {
"type": [
"number",
"null"
],
"description": "(bid - model_prob) x 100: > 0 means you could sell Yes above model value"
},
"hours_to_expiry": {
"type": "number"
},
"realized_vol_7d": {
"type": [
"number",
"null"
]
}
}
},
"description": "Only when rows is empty: the 3 liquid markets closest to min_edge_pp"
},
"filters": {
"type": "object"
},
"matched": {
"type": "integer"
},
"scanned": {
"type": "integer"
},
"spot_live": {
"type": "boolean"
},
"disclaimer": {
"type": "string"
},
"generated_at_iso": {
"type": "string",
"format": "date-time"
},
"cache_updated_iso": {
"type": "string"
},
"median_book_age_s": {
"type": [
"number",
"null"
]
},
"filtered_out_illiquid": {
"type": "integer"
},
"filtered_out_empty_books": {
"type": "integer"
}
},
"description": "Error responses are JSON {error: string}: 400 bad min_edge_pp / max_spread_pp / min_depth_usd / limit / kind (free); 404 order-book cache empty (free, never charged); 402 payment required; 502 upstream error."
}
}
}
}
}
}
}Provenance
- Seen in the source catalog
- 2026-10-17 13:17Z
- Last indexed by Roundhouse
- 2026-10-26 17:20Z
- Last enriched (probe, favicon, geo)
- 2026-10-17 15:15Z
- x402 version
- 2
- Max timeout
- 120s
- Liveness probe
- HTTP 402
Hand this page to an agent
Copy the prompt and paste it into Claude, an MCP client or your own agent — it will vet this service and call it over the free read API. No key, no account.
GET api.roundhouseai.io/v0/endpoints
This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 13 snapshots so far. Verified volume counts only settlements with an on-chain EIP-3009 marker.
Show the promptHide the prompt
Using Roundhouse, look up the x402 service Perp Gap API and tell me whether it is worth paying: what a call costs, whether the endpoint answered when last probed, and what its payment record actually shows. curl -s 'https://api.roundhouseai.io/v0/endpoints?q=Perp%20Gap%20API' curl -s 'https://api.roundhouseai.io/v0/merchants/<the payTo wallet returned above>' Then call it: read the price from the live 402 at https://perp-gap-api.perpgap.workers.dev/pm/scan, never from a cached figure, and pay with an x402 client. The /v0 API needs an API key (`authorization: Bearer rh_live_…`) on everything except /v0/unified* and /v0/endpoints. Either pay over x402 (mint a personal key for $0.01 at GET https://api.roundhouseai.io/v0/test/x402), or ask me for an organization key, which I create at https://roundhouseai.io/dashboard/connections. If you have neither, ask before going further. If you do not have Roundhouse tools or skills installed, read https://roundhouseai.io/skill.md first — it is the whole procedure.