{"uid":"cap_fZ88u90WSHPRsh2QQv1wY","slug":"perp-gap-api-tokenized-stock-pool-liquidity-41a34c49","name":"Perp Gap API – Tokenized Stock Pool Liquidity","description":"Use before sizing a tokenized-stock trade or choosing between xStocks and Ondo for execution. For one ticker: each token's Solana pool liquidity, price impact of a $10k buy and sell, rough size executable within 1%, a tradable flag, and Ondo's issuer mint/redeem market. Bad params return 400/404 before any charge. Errors: 400, 402, 404, 502. Data, not advice.","url":"https://perp-gap-api.perpgap.workers.dev/tokens/liquidity?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":["ticker"],"properties":{"ticker":{"type":"string","pattern":"^[A-Za-z0-9.]{1,12}$","examples":["NVDA"],"description":"Stock ticker, case-insensitive (free list: GET /catalog)."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"as_of":{"type":"string"},"method":{"type":"string"},"ticker":{"type":"string"},"tokens":{"type":"array"},"summary":{"type":"object"},"disclaimer":{"type":"string"},"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."}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_g2k6V4eGwXP0ib_MEqQum","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns Solana DEX pool liquidity, price impact, executable size within 1%, tradable flag, and Ondo issuer market data for a single tokenized stock ticker (e.g. xStocks vs Ondo).","exampleAgentPrompt":"Before I put on a $25k tokenized NVDA trade, check the Solana pool liquidity for NVDA — I want to know the price impact of a $10k buy and sell, how much I can execute within 1% slippage, whether it's tradable, and what the Ondo issuer market looks like.","exampleUseCases":[{"title":"Pre-trade liquidity check for xStocks","prompt":"I'm about to buy $15k of tokenized TSLA — can you pull the Solana pool liquidity for TSLA, show me the price impact of a $10k buy and sell, and tell me if it's actually tradable right now?"},{"title":"Choosing between xStocks and Ondo for execution","prompt":"I need to decide whether to use xStocks or Ondo to execute a tokenized AAPL position — can you check the liquidity data for AAPL and tell me which venue looks better?"},{"title":"Sizing a tokenized stock position within 1% slippage","prompt":"I want to know the maximum size I can trade in tokenized MSFT on Solana while staying within 1% price impact — pull the liquidity stats for MSFT for me."}],"resultDescription":"A JSON object containing: timestamp (as_of), ticker, US session status, an array of token entries (each with pool liquidity, $10k buy/sell price impact, rough executable size within 1% slippage, and tradable flag), a summary object, an Ondo issuer mint/redeem market entry, and a disclaimer. Errors return JSON with an error string and optional hint.","failureModes":["400 – Bad or malformed ticker parameter (not charged)","402 – Payment required (x402 micropayment not provided)","404 – Ticker or market not listed; checked before settlement so never charged","502 – Upstream data provider error; liquidity data unavailable"],"whenToPreferThis":"Use this endpoint when an AI agent needs to assess execution feasibility for a tokenized stock trade on Solana — specifically to compare xStocks vs Ondo liquidity, understand price impact, or determine the maximum tradable size before committing. Prefer over generic DEX aggregators when you need structured per-token liquidity data including Ondo issuer market context for a single stock ticker.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:35:04.257Z","isFirstParty":false,"canonicalSlug":"perp-gap-api-tokenized-stock-pool-liquidity-41a34c49"}