{"uid":"cap_YGwHMUNsgXYJ1HRUsnWCV","slug":"x402stock-us-stocks-endpoint-4416abe1","name":"x402stock US Stocks Endpoint","description":"Tokenized-equity (xStocks) on-chain prices vs. underlyings, with premium.","url":"https://agents.x402stock.xyz/api/v1/xstocks?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false}}},"responseSchema":{"type":"object","required":["source","as_of","venue","protocol","program","note","us_market_open","sections","count","items"],"properties":{"note":{"type":"string"},"as_of":{"type":"string"},"count":{"type":"number"},"items":{"type":"array","items":{"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}},"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":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Iysu8werQS2emt1tieiRD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_Qf1nkj6SbCdtV1ORaUEVj","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves US stock and ETF market data (quotes, prices, fundamentals) for AI agents via pay-per-request USDC payments","exampleAgentPrompt":"Can you pull the latest market data for NVDA from x402stock? I want to see current price and any available fundamentals.","exampleUseCases":[{"title":"Portfolio valuation snapshot","prompt":"I need current price data for AAPL, MSFT, and TSLA from x402stock to value my portfolio — can you fetch each one?"},{"title":"ETF research for allocation","prompt":"Look up the latest market data for SPY and QQQ on x402stock so I can compare them before rebalancing my ETF allocation."},{"title":"Stock screening for trading agent","prompt":"My trading bot needs to check the current quote for AMD on x402stock — fetch the market data and return the price and any available details."}],"resultDescription":"Returns market data for the requested US stock or ETF ticker, including price, quote, and any available fundamental or descriptive fields, delivered as a JSON response after a per-request USDC payment via x402 protocol.","failureModes":["Invalid or unrecognized ticker symbol returns an error or empty result","Insufficient USDC balance causes payment failure and request rejection","Ticker not listed on a US exchange may not be supported","Rate limiting or network issues may cause transient failures","Malformed properties parameter may return unexpected data subsets"],"whenToPreferThis":"Choose this endpoint when you need US stock or ETF market data without a long-term API subscription, especially in an agentic context where autonomous pay-per-request USDC payments via x402 are acceptable. Ideal for AI agents that need occasional equity lookups without account setup overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T06:52:13.673Z","isFirstParty":false,"canonicalSlug":"x402stock-us-stocks-endpoint-4416abe1"}