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.

TradingLiveeip155:8453Exactvia cdp
TradingDataStocksPerpsTokenized-stocks
Calls · 30d
3
This endpoint's own trailing-30-day call count, as published by the upstream catalog and snapshotted daily. 3 snapshots so far.
$0.77
Verified settled volume
37 settlements proven x402 by their on-chain EIP-3009 marker.
$0.010
Listed price
As published in the catalog. Always read the live 402 before paying.
3
Calls · 30d
Upstream's own call count for this endpoint, not ours.
2
Unique payers · 30d
Last called 2026-10-23 07:13Z
—
Upstream on-chain volume
Reported by the source catalog.
Paid to
0x2d82dcB9cC3a168d9Ab25b62C1E33E278A51254F

The 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.01USDC≈ $0.01 USD
on Base · exact scheme

Pay 0.01 USDC on Base to 0x2d82…1254F. The signed payment is good for 2 minutes.

USD Coin contract
0x8335…02913
Payment window
2 minutes
As published
10000 smallest units
10000units
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.

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
Report

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.

Open skill.md
Show 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.