{"uid":"cap_0jTzTOnr_yvnQkTp8Bigw","slug":"x402stock-spot-order-book-7b278c2f","name":"x402stock Spot Order Book","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/orderbook/%7Btoken%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"id":"PURR/USDC","asks":[{"size":1200,"price":0.097,"orders":6}],"bids":[{"size":1000,"price":0.0969,"orders":5}],"pair":"PURR/USDC","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_Exsdjy_NjInQAj1J_9Zfh","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 the current spot order book (bids and asks) for a given token trading pair on Hyperliquid","exampleAgentPrompt":"What does the current spot order book look like for PURR/USDC — show me the bids and asks with sizes and prices right now.","exampleUseCases":[{"title":"Check liquidity before large trade","prompt":"Before I buy a large position in HYPE/USDC on Hyperliquid, can you pull up the full order book so I can see how much liquidity is available at different price levels and estimate my market impact?"},{"title":"Arbitrage spread analysis across pairs","prompt":"I want to look for arbitrage opportunities — can you fetch the live bid-ask order book for PURR/USDC on Hyperliquid and tell me what the current spread looks like and where the best entry and exit prices are?"},{"title":"Market depth snapshot for research","prompt":"I'm researching how liquid the spot market is for a few tokens on Hyperliquid. Can you grab the current order book depth for FRIEND/USDC and show me the top bid and ask levels with their sizes?"}],"resultDescription":"Returns a JSON object containing the token pair identifier, an array of ask levels (price, size, number of orders), an array of bid levels (price, size, number of orders), the venue (e.g. hyperliquid), market type (spot), and an as_of timestamp indicating when the snapshot was taken.","failureModes":["Unknown or unsupported token symbol returns 404 or empty result","Token pair with no active market returns empty bids/asks arrays","Stale data if Hyperliquid feed is delayed","Rate limiting or payment failure if USDC balance insufficient for x402 payment","Malformed token path parameter returns 400 error"],"whenToPreferThis":"Use this endpoint when you need real-time spot order book depth for tokens trading on Hyperliquid DEX — specifically bid/ask price levels, order sizes, and market liquidity snapshots. Prefer this over generic price endpoints when you need full depth-of-market data rather than just a last-traded price. Ideal for agents performing arbitrage analysis, liquidity assessment, or market-making research on Hyperliquid spot pairs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:54:35.058Z","isFirstParty":false}