{"uid":"cap_LHtdjSI_Dq_XxKCXULi7R","slug":"perp-gap-api-tokenized-stock-premium-discount-checker-efb31822","name":"Perp Gap API – Tokenized Stock Premium/Discount Checker","description":"Use before buying or pricing a tokenized stock (NVDAx, NVDAon) to see if it trades rich or cheap vs the real share. For one ticker, up to 10, or tickers=all: each xStocks and Ondo Global Markets token's price per share vs the stock reference, premium %, Ondo issuer price, freshness, chain and pool liquidity. 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/premium?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)."},"tickers":{"type":"string","description":"Optional alternative to ticker: up to 10 comma-separated tickers, or 'all'."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"mode":{"type":"string"},"rows":{"type":"array"},"as_of":{"type":"string"},"count":{"type":"number"},"notes":{"type":"string"},"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_Xm3uumVb5IOqC7ia88il9","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 the current price premium or discount of tokenized stock tokens (xStocks, Ondo) versus the real underlying share price, with liquidity and freshness data","exampleAgentPrompt":"Before I buy NVDAx, check the Perp Gap premium data for NVDA — is the tokenized xStocks version trading rich or cheap versus the real share, and what's the pool liquidity look like?","exampleUseCases":[{"title":"Spot arbitrage on tokenized NVIDIA stock","prompt":"I'm thinking of buying NVDAon. Can you pull the current premium or discount versus the real NVDA share price and tell me if the Ondo token is cheap or expensive right now?"},{"title":"Scan all tokenized stocks for mispricings","prompt":"Run a full scan across all tokenized stocks and show me which ones are most mispriced — I want to see every token's premium percentage, liquidity, and how fresh the data is."},{"title":"Compare xStocks vs Ondo for TSLA entry","prompt":"I want to get exposure to TSLA via a tokenized token. Pull the premium data for both the xStocks and Ondo versions of TSLA so I can see which one is closer to fair value and has better liquidity."}],"resultDescription":"Returns a JSON object with a rows array where each entry contains: token symbol, token price per share, stock reference price, premium percentage, Ondo issuer price (if applicable), data freshness timestamp, blockchain chain, and pool liquidity. Also includes mode, as_of timestamp, count, notes, disclaimer, and US session indicator. Errors return JSON with error string and optional hint.","failureModes":["400 Bad Request: invalid ticker format or unsupported parameters — not charged","402 Payment Required: x402 micropayment not settled","404 Not Found: ticker or market not listed — checked before settlement, not charged","502 Bad Gateway: upstream data source unavailable"],"whenToPreferThis":"Use this endpoint when an agent needs to evaluate whether a tokenized stock (xStocks or Ondo Global Markets) is trading at a fair price relative to the real underlying share before executing a trade or pricing a position. It covers both single-ticker and multi-ticker lookups (up to 10 or all), and provides premium %, liquidity, and freshness in one call. Prefer this over generic price feeds when the specific use case is tokenized-stock premium/discount analysis across DeFi venues.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T13:21:53.666Z","isFirstParty":false,"canonicalSlug":"perp-gap-api-tokenized-stock-premium-discount-checker-efb31822"}