Perp Gap API
Use when an agent needs the best live price for a stock across venues before trading. For 1-10 tickers: perp mark and mid on trade.xyz (Hyperliquid), Aster, Lighter and OKX, xStocks and Ondo token prices per share, last US close, the session reference price, gap % vs it, cross-venue spread, best bid/ask and freshness. Unpaid calls get 402; bad or unknown tickers get 400/404 before any charge. Errors: 400, 402, 404, 502. Data, not advice.
The wallet the 402 directs payment to. Its whole payment record — every payer, every chain — is on the merchant page.
Asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
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.
Pay 0.01 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
- 10000 smallest units
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": "10000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 120
},
{
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"extra": {
"feePayer": "BFK9TLC3edb13K6v4YyH3DwPb5DSUpkWvb7XnqCL9b4F"
},
"payTo": "5MoL8HNnvZUogGrqiF4T1StmAUpdU7ERA2GUJ7gLrEja",
"amount": "10000",
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"maxTimeoutSeconds": 120
}
]Extensions
{
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"ticker": "NVDA"
}
},
"output": {
"type": "json",
"example": {
"as_of": "2026-10-22T21:41:01.558Z",
"perps": {
"okx": {
"ask": 213.17,
"bid": 213.16,
"mid": 213.165,
"last": 213.17,
"mark": 213.16,
"symbol": "NVDA-USDT-SWAP"
},
"aster": {
"ask": 213.19,
"bid": 213.17,
"mid": 213.18,
"mark": 213.1046,
"index": 213.1046,
"symbol": "NVDAUSDT"
},
"lighter": {
"ask": 212.993,
"bid": 212.972,
"mid": 212.9825,
"mark": 212.981,
"symbol": "NVDA",
"market_id": 110
},
"hyperliquid-xyz": {
"ask": 212.85,
"bid": 212.837,
"mid": 212.845,
"mark": 212.86,
"oracle": 212.89,
"symbol": "xyz:NVDA"
}
},
"ticker": "NVDA",
"tokens": {
"ondo-gm": {
"price": 213.2652,
"status": "postmarket",
"symbol": "NVDAon",
"per_share": 212.9,
"multiplier": 1.0017152487959897,
"underlying_price": 212.837895
},
"xstocks-solana": {
"mint": "Xsc9qvGR1efVDFGLrVsmkzv3qi45LTBjeUKSPmx9qEh",
"price": 212.3166,
"symbol": "NVDAx",
"per_share": 212.3166,
"multiplier": 1.0009180758490996,
"liquidity_usd": 2852537
}
},
"sources": [
"hyperliquid"
],
"summary": {
"richest": "okx",
"best_ask": {
"px": 212.85,
"venue": "hyperliquid-xyz"
},
"best_bid": {
"px": 213.17,
"venue": "aster"
},
"cheapest": "hyperliquid-xyz",
"consensus_mid": 212.9413,
"venues_quoted": 6,
"cross_venue_arb_bps": 15,
"consensus_vs_ref_pct": 0.029,
"perp_mark_spread_pct": 0.141
},
"reference": {
"ts": 1792705247,
"kind": "after-hours_last",
"age_s": 14,
"price": 212.88,
"source": "robinhood"
},
"last_close": {
"date": "2026-10-22",
"price": 212.21,
"source": "yahoo",
"ref_vs_close_pct": 0.316
},
"us_session": "after-hours"
}
}
},
"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": [
"ticker"
],
"properties": {
"ticker": {
"type": "string",
"pattern": "^[A-Za-z0-9.]{1,12}$",
"examples": [
"NVDA"
],
"description": "Stock ticker, case-insensitive (free list: GET /catalog)."
},
"tickers": {
"type": "string",
"pattern": "^[A-Za-z0-9.,]{1,130}$",
"examples": [
"NVDA,TSLA"
],
"description": "Optional alternative to ticker: up to 10 comma-separated tickers."
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"output": {
"type": "object",
"required": [
"type"
],
"properties": {
"type": {
"type": "string"
},
"example": {
"type": "object",
"properties": {
"as_of": {
"type": "string"
},
"perps": {
"type": "object"
},
"ticker": {
"type": "string"
},
"tokens": {
"type": "object"
},
"sources": {
"type": "array"
},
"summary": {
"type": "object"
},
"reference": {
"type": "object"
},
"last_close": {
"type": "object"
},
"us_session": {
"type": "string"
}
},
"description": "Error responses are JSON {error: string, hint?: string}. 400 bad params (never charged); 402 payment required; 404 ticker/market not listed (checked before settlement, never charged); 502 upstream error. Full field docs: /openapi.json."
}
}
}
}
}
}
}Provenance
- Seen in the source catalog
- 2026-10-23 07:13Z
- Last indexed by Roundhouse
- 2026-10-25 08:40Z
- Last enriched (probe, favicon, geo)
- 2026-10-22 23:16Z
- 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. 3 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/quote, 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.