{"uid":"cap_FteuqluKyHLFB1hTo39Cb","slug":"agents-x402stock-xyz-xstock-tokenized-equity-tracker-on-chain-vs-3fb58f02","name":"xStock Tokenized Equity Tracker — On-Chain vs Underlying Price","description":"Use to track one tokenized equity by xStock symbol (AAPLx) or underlying ticker (AAPL): the on-chain Raydium CLMM pool price from the public Solana ledger, the per-share price after its Token-2022 scaled-UI multiplier, the underlying's live quote, and the premium/discount percent. List every tracked symbol via /xstocks. From x402stock, a market & economic data API (x402, USDC).","url":"https://agents.x402stock.xyz/api/v1/xstocks/{ticker}","method":"GET","headers":{},"bodySchema":{"type":"object","required":["ticker"],"properties":{"ticker":{"type":"string","description":"US-listed ticker symbol (uppercase), e.g. AAPL."}}},"responseSchema":{"type":"object","required":["source","as_of","venue","protocol","program","note","us_market_open","sections","item"],"properties":{"item":{"type":"object","required":["symbol","underlying","pool","mint","xstock_price_usd","pool_price_raw_unit","multiplier","liquidity","tick_current","underlying_price_usd","underlying_change_percent","underlying_market_status","premium_percent"],"properties":{"mint":{"anyOf":[{"type":"string"},{"type":"null"}]},"pool":{"type":"string"},"symbol":{"type":"string"},"liquidity":{"anyOf":[{"type":"number"},{"type":"null"}]},"multiplier":{"type":"number"},"underlying":{"type":"string"},"tick_current":{"anyOf":[{"type":"number"},{"type":"null"}]},"premium_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"xstock_price_usd":{"anyOf":[{"type":"number"},{"type":"null"}]},"pool_price_raw_unit":{"anyOf":[{"type":"number"},{"type":"null"}]},"underlying_price_usd":{"anyOf":[{"type":"number"},{"type":"null"}]},"underlying_market_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"underlying_change_percent":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},"note":{"type":"string"},"as_of":{"type":"string"},"venue":{"type":"string","const":"solana"},"source":{"type":"string","const":"x402stock"},"program":{"type":"string"},"protocol":{"type":"string","const":"raydium-clmm"},"sections":{"type":"object","required":["onchain","underlying"],"properties":{"onchain":{"type":"string","const":"ok"},"underlying":{"enum":["ok","unavailable"],"type":"string"}},"additionalProperties":false},"us_market_open":{"anyOf":[{"type":"boolean"},{"type":"null"}]}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.02","displayCostAsset":"USD","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":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ybkXLXh-sJoM5TRXY6V1j","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.x402stock.xyz","brandSlug":"agents-x402stock-xyz-mpp","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"Returns on-chain Raydium CLMM pool price, scaled xStock per-share price, live underlying equity quote, and premium/discount percent for a single tokenized equity on Solana.","exampleAgentPrompt":"What's the current xStock on-chain price for AAPL on Solana, and is it trading at a premium or discount to the real Apple share price right now?","exampleUseCases":[{"title":"Arbitrage alert between xStock and NYSE","prompt":"Check if AAPLx on Solana is trading at a significant premium or discount to the real AAPL stock price — I want to know the percentage difference right now."},{"title":"DeFi portfolio tracker for tokenized equities","prompt":"Pull the current on-chain price and underlying quote for TSLAx so I can update my DeFi portfolio valuation versus what Tesla is actually trading at on the stock market."},{"title":"Liquidity check before trading xStock","prompt":"Before I trade MSFTx on Raydium, can you tell me the current pool liquidity, the pool address, and whether the tokenized price is in line with the real Microsoft share price?"}],"resultDescription":"Returns a JSON object with the xStock symbol, underlying ticker, Raydium CLMM pool address, mint address, current xstock_price_usd (after Token-2022 scaled-UI multiplier), raw pool price, on-chain liquidity, current tick, live underlying_price_usd, underlying_change_percent, underlying_market_status, premium_percent (positive = xStock is expensive, negative = discount), whether the US market is open, data timestamp, and status flags for on-chain and underlying data availability.","failureModes":["Unknown ticker: endpoint may return empty or error if the symbol is not tracked — use /xstocks to list valid symbols","Underlying price unavailable: sections.underlying = 'unavailable' when the live equity quote cannot be fetched (e.g. market closed or data outage), premium_percent and underlying_price_usd will be null","On-chain data unavailable: pool data may be stale or null if the Solana RPC or Raydium indexer is degraded","Payment failure: x402 USDC micropayment of $0.02 not fulfilled results in 402 response","Invalid ticker format: passing lowercase or non-existent ticker returns an error"],"whenToPreferThis":"Use this endpoint when you need a real-time comparison of a Solana tokenized equity's on-chain price (via Raydium CLMM) against its underlying US stock quote, including the premium/discount spread. Prefer this over generic crypto price endpoints when the asset is specifically an xStock Token-2022 token on Solana. Also prefer when you need pool-level data (liquidity, tick, mint address) for a tokenized equity rather than just a spot price.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-09T18:30:01.926Z","isFirstParty":false}