{"uid":"cap_Y_Xz6sBLd-5rnEZkEOPoJ","slug":"x402stock-xstocks-on-chain-price-lookup-52c34667","name":"x402stock xStocks On-Chain Price Lookup","description":"Pay-per-call market and economic data API for AI agents: US stocks, ETFs and options, forex, crypto and on-chain perps, energy commodities, US and global macro (Fed, CPI, jobs, GDP, Treasury, World Bank), SEC filings, congressional trades, and market sentiment. No API keys, no accounts. Pay per request in USDC via x402 on Base.","url":"https://x402stock.xyz/api/v1/xstocks/%7Bticker%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"item":{"mint":"XsbEhLAtcf6HdfpFZ5xEMdqW8nfAvcsP5bdudRLJzJp","pool":"CKwJZwm7oj3nu4653N1EpDrqXbXAYXoPFiPeEnLouF8y","symbol":"AAPLx","liquidity":8312047113.2,"multiplier":1.000139,"underlying":"AAPL","tick_current":10688,"premium_percent":0.24,"xstock_price_usd":291.12,"pool_price_raw_unit":291.16,"underlying_price_usd":290.43,"underlying_market_status":"closed","underlying_change_percent":0.82},"note":"xStock prices decoded from Raydium CLMM pool state (sqrt_price_x64) on the public Solana ledger — not from any Backed/xStocks, Chainlink, or Pyth API. Per-share price accounts for the Token-2022 scaled-UI multiplier. The AMM price is arb-anchored to the underlying only while US markets are open (us_market_open); off-hours it is the market's standing 24/7 price discovery.","as_of":"2026-06-08T13:02:11.000Z","venue":"solana","source":"x402stock","program":"CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK","protocol":"raydium-clmm","sections":{"onchain":"ok","underlying":"ok"},"us_market_open":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_J37eWAhWWX2Pm3GgvN4bL","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 real-time on-chain price data for a tokenized xStock (e.g. AAPLx) by ticker, decoded from Raydium CLMM pool state on Solana, including underlying equity price, premium, liquidity, and market status.","exampleAgentPrompt":"What's the current on-chain xStock price for AAPL — how does it compare to the real stock price, and is there a significant premium right now?","exampleUseCases":null,"resultDescription":"A JSON object with the xStock's on-chain AMM price in USD, the underlying equity's last price, the premium percent, pool liquidity, mint and pool addresses, the current tick, the scaled-UI multiplier, whether the US market is open, and an as-of timestamp. Also includes notes on price source (Raydium CLMM sqrt_price_x64) and data sections status.","failureModes":["Invalid or unsupported ticker returns an error or empty result","Ticker format mismatch (e.g. 'AAPLx' vs 'AAPL') may cause lookup failure","Solana RPC unavailability could cause on-chain data fetch to fail","Payment failure via x402/USDC on Base blocks the request","Off-hours prices reflect 24/7 AMM market discovery, not arb-anchored underlying price — may diverge significantly"],"whenToPreferThis":"Use this endpoint when you need the live on-chain AMM price of a tokenized US equity (xStock) on Solana, especially to compare it against the real underlying stock price or measure the current premium/discount. Prefer this over traditional stock price APIs when the use case involves DeFi, Solana-native tokenized equities, or Raydium CLMM pool state.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:07:01.368Z","isFirstParty":false}