{"uid":"cap_GmdtbQzcW0q0blXBuAOsc","slug":"perp-gap-api-full-market-catalog-f7033f0d","name":"Perp Gap API – Full Market Catalog","description":"Catalog of every stock perp and tokenized stock agents can trade: Hyperliquid trade.xyz, Aster and Lighter perps plus Solana xStocks and Ondo Global Markets tokens (2,200+ markets). Per market: ticker, venue, symbol or mint, underlying, type (US stock, ETF, index, intl, pre-IPO), live and tradable-now flags. Use first to see which venues list a ticker and get the exact symbol before calling /quote, /funding or /gaps. Same data is free at GET /catalog.","url":"https://perp-gap-api.perpgap.workers.dev/catalog/full?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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":{"type":{"type":"string","examples":["us_equity"],"description":"Optional comma-separated types: us_equity, us_etf, index, intl_equity, pre_ipo, other."},"group":{"enum":["1"],"type":"string","examples":["1"],"description":"Optional: '1' groups markets by ticker (where can I trade X?)."},"venue":{"type":"string","examples":["aster,lighter"],"description":"Optional comma-separated venues: hyperliquid-xyz, aster, lighter, xstocks-solana, ondo-gm."},"format":{"enum":["json","csv"],"type":"string","examples":["csv"],"description":"Optional: csv for a flat table."},"ticker":{"type":"string","examples":["TSLA,NVDA"],"description":"Optional comma-separated tickers."},"compact":{"enum":["1"],"type":"string","examples":["1"],"description":"Optional: '1' drops ids, names and ISINs."},"tradable":{"enum":["1"],"type":"string","examples":["1"],"description":"Optional: '1' keeps markets that accept orders right now."},"instrument":{"enum":["perp","token"],"type":"string","examples":["perp"],"description":"Optional: perps only or tokenized stocks only."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["count"],"properties":{"rows":{"type":"array","items":{"type":"object","required":["ticker","venue","symbol","type","instrument","live"],"properties":{"ids":{"type":"object"},"live":{"type":"boolean"},"mark":{"type":["number","null"]},"type":{"enum":["us_equity","us_etf","index","intl_equity","pre_ipo","other"],"type":"string"},"venue":{"enum":["hyperliquid-xyz","aster","lighter","xstocks-solana","ondo-gm"],"type":"string"},"symbol":{"type":"string"},"ticker":{"type":"string"},"instrument":{"enum":["perp","token"],"type":"string"},"multiplier":{"type":["number","null"]},"underlying":{"type":"string"},"quote_asset":{"type":"string"},"tradable_now":{"type":["boolean","null"]}}}},"count":{"type":"integer"},"venues":{"type":"object"},"tickers":{"type":"array","items":{"type":"object"},"description":"group=1 mode"},"freshness":{"type":["object","null"]},"generated_at":{"type":"string"}},"description":"Error responses are JSON {error: string}: 400 unknown venue; 402 payment required; 502 storage error."}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_sAarX3X0H2ScZFmtPeH0F","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a complete catalog of 2,200+ tokenized stock and perpetual futures markets across Hyperliquid, Aster, Lighter, xStocks (Solana), and Ondo Global Markets, with per-market metadata including ticker, venue, symbol/mint, asset type, and live/tradable flags.","exampleAgentPrompt":"Before you fetch the funding rate for TSLA, check the Perp Gap catalog to see which venues list it and grab the exact trading symbol I need for each one — filter to US equity perps only.","exampleUseCases":[{"title":"Pre-trade venue discovery for a stock","prompt":"I want to trade NVDA perps — can you check the Perp Gap catalog and tell me every venue that lists it, whether it's live, and what symbol I should use when I call the quote endpoint?"},{"title":"Tradable market scan before execution","prompt":"Pull the full catalog from Perp Gap filtered to markets that are tradable right now and are US equities, so I know exactly what I can place an order on across Hyperliquid, Aster, and Lighter."},{"title":"Tokenized stock discovery on Solana","prompt":"Show me all the tokenized stocks available on xStocks Solana from the Perp Gap catalog — I need the ticker, mint address, and whether each one is currently live."}],"resultDescription":"A JSON array (or CSV table) of market rows, each containing: ticker, venue identifier, trading symbol or on-chain mint address, underlying asset name, asset type enum (us_equity, us_etf, index, intl_equity, pre_ipo, other), instrument type (perp or token), live boolean, tradable boolean, and optionally mark price, IDs, and ISIN. Total count is included. When grouped by ticker, rows are clustered to show all venues listing a given ticker together.","failureModes":["Invalid ticker or venue parameter returns empty result set rather than an error","Unsupported enum value in type/venue/instrument/format parameters causes a 400 validation error","Payment not included or insufficient causes 402 Payment Required response","Markets flagged live=true may temporarily become untradable between catalog refresh cycles","Compact mode drops IDs and ISINs — downstream calls needing those fields will fail if compact=1 was used"],"whenToPreferThis":"Use this endpoint first, before calling any /quote, /funding, or /gaps endpoint, to discover which venues list a given ticker and to retrieve the exact symbol or mint address required by those endpoints. Prefer this over ad-hoc symbol guessing when you need to enumerate all available markets for a given asset type, filter to currently tradable markets, or compare venue coverage across Hyperliquid, Aster, Lighter, xStocks Solana, and Ondo Global Markets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T12:36:58.625Z","isFirstParty":false,"canonicalSlug":"perp-gap-api-full-market-catalog-f7033f0d"}