{"uid":"cap_6o28Q6sWmskQtL2qagQ8d","slug":"agents-x402stock-xyz-hyperliquid-spot-market-data-by-token-symbol-c9b1a195","name":"Hyperliquid Spot Market Data by Token Symbol","description":"Live on-chain spot market for one Hyperliquid-listed token by symbol (e.g. HYPE, PURR) or @index: mid/mark price, previous-day price, 24h USD and base volume, circulating and total supply, and market cap, quoted in USDC. Spot, not a perp — for funding/open interest use /api/v1/perps/{coin}; for major-coin fiat prices use /api/v1/crypto. From x402stock, a market & economic data API (x402, USDC).","url":"https://agents.x402stock.xyz/api/v1/spot/{token}","method":"GET","headers":{},"bodySchema":{"type":"object","required":["token"],"properties":{"token":{"type":"string","description":"Hyperliquid spot token symbol, e.g. PURR."}}},"responseSchema":{"type":"object","required":["source","as_of","venue","market","data"],"properties":{"data":{"type":"object","required":["pair","id","base_token","quote_token","canonical","mark_price","mid_price","prev_day_price","day_volume_usd","day_volume_base","circulating_supply","total_supply","market_cap_usd"],"properties":{"id":{"type":"string"},"pair":{"type":"string"},"canonical":{"type":"boolean"},"mid_price":{"anyOf":[{"type":"number"},{"type":"null"}]},"base_token":{"type":"string"},"mark_price":{"anyOf":[{"type":"number"},{"type":"null"}]},"quote_token":{"type":"string"},"total_supply":{"anyOf":[{"type":"number"},{"type":"null"}]},"day_volume_usd":{"anyOf":[{"type":"number"},{"type":"null"}]},"market_cap_usd":{"anyOf":[{"type":"number"},{"type":"null"}]},"prev_day_price":{"anyOf":[{"type":"number"},{"type":"null"}]},"day_volume_base":{"anyOf":[{"type":"number"},{"type":"null"}]},"circulating_supply":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},"as_of":{"type":"string"},"venue":{"type":"string"},"market":{"type":"string","const":"spot"},"source":{"type":"string","const":"x402stock"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oDV4wBshhGq4Y9CARWYeg","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","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 live on-chain spot market data for a Hyperliquid-listed token including mid/mark price, 24h volume, supply, and market cap in USDC","exampleAgentPrompt":"What's the current spot price and 24-hour trading volume for HYPE on Hyperliquid, and what's its market cap right now?","exampleUseCases":[{"title":"Real-time HYPE price check","prompt":"What's the live mid price and mark price for HYPE on Hyperliquid spot right now, and how does it compare to yesterday's price?"},{"title":"Token market cap monitoring","prompt":"Look up the current market cap and circulating supply for PURR on the Hyperliquid spot market."},{"title":"24h volume analysis for trading","prompt":"How much volume in USD has the HYPE spot token done in the last 24 hours on Hyperliquid?"}],"resultDescription":"A JSON object containing the token pair identifier, base and quote token names, canonical flag, live mid price, mark price, previous day closing price, 24-hour volume in USD and in base token units, circulating and total supply, and market cap in USDC, along with the data source, venue, market type (spot), and timestamp.","failureModes":["Unknown or unsupported token symbol returns an error — only Hyperliquid-listed spot tokens are valid","Requesting a perpetuals contract symbol instead of a spot token will fail — use /api/v1/perps/{coin} for perps","Requesting a major coin like BTC or ETH that is not listed on Hyperliquid spot may return no data — use /api/v1/crypto for those","Payment failure via x402/USDC will block the response","Null values for fields like mid_price or market_cap may be returned if the token has no recent activity"],"whenToPreferThis":"Use this endpoint when you need live on-chain spot market data specifically for tokens listed on Hyperliquid DEX, including niche or community tokens like PURR and HYPE. Prefer this over /api/v1/crypto for Hyperliquid-native tokens and over /api/v1/perps for spot (not perpetual) price data. Ideal for agents monitoring DeFi token prices, supply metrics, or market cap in real time without needing an API key.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-10T06:42:47.794Z","isFirstParty":false}