{"uid":"cap_9NkBCp7W9Gv6jtpOgBtPn","slug":"st0x-tokenized-equities-premium-discount-by-ticker-36e049b0","name":"ST0x Tokenized Equities — Premium/Discount by Ticker","description":"Use this when the question is whether an ST0x tokenized stock on Base trades above or below the real share: send a ticker (NVDA, wtAAPL, FGI) and get the premium/discount in basis points from the deepest USDC pool (live) and the last Raindex fill vs the exchange quote, corrected for the ERC-4626 wrapper rate, with market session, age of every leg, pool depth, any cross-issuer pool (wtNVDA vs Coinbase NVDAc), and a one-sentence read. Unknown ticker -> 404, no charge.","url":"https://x402-accelerometer-feed.fly.dev/tokenized-equities/st0x/premium/:ticker","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"},"pathParams":{"type":"object","required":["ticker"],"properties":{"ticker":{"type":"string","description":"stock ticker (NVDA), ST0x symbol (wtNVDA / tNVDA), or the token's Base address"}}},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"kind":{"type":"string"},"read":{"type":"string"},"as_of":{"type":"string"},"chain":{"type":"string"},"token":{"type":"object","properties":{"isin":{"type":["string","null"]},"name":{"type":"string"},"symbol":{"type":"string"},"ticker":{"type":"string"},"wrapped":{"type":"string"},"unwrapped":{"type":["string","null"]},"wrapper_rate":{"type":["number","null"]}}},"sources":{"type":"object"},"on_chain":{"type":"object","properties":{"best_usdc_pool":{"type":["object","null"]},"cross_issuer_pools":{"type":"array"},"raindex_last_trade":{"type":["object","null"]}}},"disclaimer":{"type":"string"},"underlying":{"type":["object","null"],"properties":{"age_s":{"type":"number"},"price":{"type":"number"},"source":{"type":"string"},"symbol":{"type":"string"},"session":{"type":"string"},"currency":{"type":["string","null"]},"exchange":{"type":["string","null"]},"leg_used":{"type":"string"},"price_at":{"type":"string"}}},"premium_bps":{"type":"object","properties":{"pool_rate_adjusted":{"type":["number","null"]},"pool_vs_underlying":{"type":["number","null"]},"raindex_rate_adjusted":{"type":["number","null"]},"raindex_vs_underlying":{"type":["number","null"]}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AkNmtXA8V2J0XDorNyCyw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the live premium or discount (in basis points) of a tokenized stock on Base vs its real-world exchange price, using the deepest USDC pool and last Raindex fill, corrected for ERC-4626 wrapper rate.","exampleAgentPrompt":"Is the ST0x tokenized NVDA on Base trading at a premium or discount right now? Give me the basis points spread and a quick read on the situation.","exampleUseCases":[{"title":"Arbitrage check for tokenized NVDA","prompt":"Check if tokenized NVDA on Base (wtNVDA) is trading above or below the real NASDAQ price right now — I need the premium or discount in basis points and whether there's a cross-issuer pool worth looking at."},{"title":"Portfolio NAV reconciliation for wrapped Apple stock","prompt":"What's the current premium or discount on wtAAPL versus the real Apple share price? I want to know the pool rate, the Raindex last fill, and whether the ERC-4626 wrapper rate has been accounted for."},{"title":"Monitor tokenized equity peg health","prompt":"Pull the live discount or premium on the ST0x tokenized Apple stock (tAAPL) — I need pool depth, market session, and a one-line summary so I can decide whether to rebalance my Base DeFi position."}],"resultDescription":"Returns a JSON object with: the premium/discount in basis points from the deepest USDC pool and last Raindex fill (both raw and ERC-4626 wrapper-rate-adjusted), the underlying exchange price with source, age, session, and leg metadata, best on-chain USDC pool details (address, depth, price), cross-issuer pool comparisons (e.g. wtNVDA vs NVDAc), last Raindex trade details, token metadata (symbol, ISIN, wrapped/unwrapped address, wrapper rate), market session status, and a one-sentence human-readable read. Returns 404 for unknown tickers at no charge.","failureModes":["Unknown ticker or token symbol returns 404 with no charge","Stale underlying price if exchange is closed or data source delayed — age_s field indicates staleness","No USDC pool found for obscure or illiquid tokenized tokens — best_usdc_pool may be null","Raindex last trade may be null if no recent fills","ERC-4626 wrapper rate unavailable makes rate-adjusted premium null","Network or provider outage on fly.dev may cause 5xx errors"],"whenToPreferThis":"Use this endpoint when you specifically need to compare a Base-chain ST0x tokenized equity (ERC-4626 wrapped stocks like wtNVDA, wtAAPL) against its real-world exchange price in basis points, with full data provenance including pool depth, Raindex fills, and wrapper rate correction. Prefer this over generic DEX price APIs when you need the full premium/discount picture with cross-issuer comparison and human-readable interpretation. It is the right tool for arbitrage detection, NAV reconciliation, and peg health monitoring for tokenized equities on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-18T06:44:15.252Z","isFirstParty":false}