{"uid":"cap_kbKFL2lLNMKa3NgKyHTow","slug":"x402stock-spot-price-lookup-1f47a5b6","name":"x402stock Spot 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/spot/%7Btoken%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{"id":"@107","pair":"HYPE/USDC","canonical":false,"mid_price":64.45,"base_token":"HYPE","mark_price":64.436,"quote_token":"USDC","total_supply":1000000000,"day_volume_usd":3446893.64,"market_cap_usd":21515620000,"prev_day_price":61.519,"day_volume_base":53570,"circulating_supply":333928438},"as_of":"2026-06-04T00:00:00.000Z","venue":"hyperliquid","market":"spot","source":"x402stock"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.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_v5aiWja9B4b--9yshfC4X","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 real-time spot market data (mid price, mark price, volume, market cap) for a crypto token pair on a specified venue","exampleAgentPrompt":"What's the current spot price and market cap of HYPE on Hyperliquid right now?","exampleUseCases":[{"title":"Check real-time crypto token price","prompt":"How much is SOL trading at right now on Hyperliquid, and what's the 24-hour volume?"},{"title":"Look up token circulating supply","prompt":"What's the current circulating supply and market cap of WIF on Hyperliquid?"},{"title":"Compare mid and mark price","prompt":"Can you pull the mid price and mark price for ETH/USDC on Hyperliquid so I can see if there's any spread right now?"}],"resultDescription":"Returns a JSON object with the token pair identifier, mid price, mark price, previous day price, 24-hour volume in USD and base token, market cap in USD, circulating supply, total supply, canonical flag, venue name, market type, and timestamp of the data.","failureModes":["Unknown or unsupported token symbol returns an error","Payment not received via x402/USDC results in 402 Payment Required","Malformed token path parameter returns a 400 or 404","Venue temporarily unavailable may return stale or missing data","Token with no spot market on the requested venue returns empty or error response"],"whenToPreferThis":"Use this endpoint when you need real-time spot price and market data for a crypto token (especially on-chain/DeFi venues like Hyperliquid) without requiring API keys or account setup — and when your agent can pay $0.01 USDC per call via x402 on Base. Prefer this over traditional market data APIs when operating in a permissionless, pay-per-call agent context.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:47:34.947Z","isFirstParty":false}