{"uid":"cap_jx_aCe6HaHaqcM_ZTSIOW","slug":"agents-x402stock-xyz-hyperliquid-perpetual-futures-market-overview-424a14ed","name":"Hyperliquid Perpetual Futures Market Overview (x402stock)","description":"Returns live context, funding history, order book, and price candles for one perp market.","url":"https://agents.x402stock.xyz/api/v1/perps/overview/{coin}?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["coin"],"properties":{"coin":{"type":"string","description":"Hyperliquid perpetual coin symbol, e.g. BTC or ETH."}}},"responseSchema":{"type":"object","required":["coin","source","venue","as_of","sections","context","funding","orderbook","candles"],"properties":{"coin":{"type":"string"},"as_of":{"type":"string"},"venue":{"type":"string","const":"hyperliquid"},"source":{"type":"string","const":"x402stock"},"candles":{"anyOf":[{"type":"object","required":["source","as_of","venue","coin","interval","count","candles"],"properties":{"coin":{"type":"string"},"as_of":{"type":"string"},"count":{"type":"number"},"venue":{"type":"string"},"source":{"type":"string","const":"x402stock"},"candles":{"type":"array","items":{"type":"object","required":["start","end","open","high","low","close","volume","trades"],"properties":{"end":{"anyOf":[{"type":"string"},{"type":"null"}]},"low":{"anyOf":[{"type":"number"},{"type":"null"}]},"high":{"anyOf":[{"type":"number"},{"type":"null"}]},"open":{"anyOf":[{"type":"number"},{"type":"null"}]},"close":{"anyOf":[{"type":"number"},{"type":"null"}]},"start":{"anyOf":[{"type":"string"},{"type":"null"}]},"trades":{"anyOf":[{"type":"number"},{"type":"null"}]},"volume":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}},"interval":{"type":"string"}},"additionalProperties":false},{"type":"null"}]},"context":{"anyOf":[{"type":"object","required":["source","as_of","venue","market","data"],"properties":{"data":{"type":"object","required":["coin","max_leverage","mark_price","oracle_price","mid_price","prev_day_price","funding_rate_hourly","funding_apr_percent","premium","open_interest","day_volume_usd","day_volume_base"],"properties":{"coin":{"type":"string"},"premium":{"anyOf":[{"type":"number"},{"type":"null"}]},"mid_price":{"anyOf":[{"type":"number"},{"type":"null"}]},"mark_price":{"anyOf":[{"type":"number"},{"type":"null"}]},"max_leverage":{"type":"number"},"oracle_price":{"anyOf":[{"type":"number"},{"type":"null"}]},"open_interest":{"anyOf":[{"type":"number"},{"type":"null"}]},"day_volume_usd":{"anyOf":[{"type":"number"},{"type":"null"}]},"prev_day_price":{"anyOf":[{"type":"number"},{"type":"null"}]},"day_volume_base":{"anyOf":[{"type":"number"},{"type":"null"}]},"funding_apr_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"funding_rate_hourly":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false},"as_of":{"type":"string"},"venue":{"type":"string"},"market":{"type":"string","const":"perp"},"source":{"type":"string","const":"x402stock"}},"additionalProperties":false},{"type":"null"}]},"funding":{"anyOf":[{"type":"object","required":["source","as_of","venue","coin","count","history"],"properties":{"coin":{"type":"string"},"as_of":{"type":"string"},"count":{"type":"number"},"venue":{"type":"string"},"source":{"type":"string","const":"x402stock"},"history":{"type":"array","items":{"type":"object","required":["time","funding_rate_hourly","funding_apr_percent","premium"],"properties":{"time":{"anyOf":[{"type":"string"},{"type":"null"}]},"premium":{"anyOf":[{"type":"number"},{"type":"null"}]},"funding_apr_percent":{"anyOf":[{"type":"number"},{"type":"null"}]},"funding_rate_hourly":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}}},"additionalProperties":false},{"type":"null"}]},"sections":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"orderbook":{"anyOf":[{"type":"object","required":["source","as_of","venue","coin","bids","asks"],"properties":{"asks":{"type":"array","items":{"type":"object","required":["price","size","orders"],"properties":{"size":{"anyOf":[{"type":"number"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"orders":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}},"bids":{"type":"array","items":{"type":"object","required":["price","size","orders"],"properties":{"size":{"anyOf":[{"type":"number"},{"type":"null"}]},"price":{"anyOf":[{"type":"number"},{"type":"null"}]},"orders":{"anyOf":[{"type":"number"},{"type":"null"}]}},"additionalProperties":false}},"coin":{"type":"string"},"as_of":{"type":"string"},"venue":{"type":"string"},"source":{"type":"string","const":"x402stock"}},"additionalProperties":false},{"type":"null"}]}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_I9IeGfqK-bdZcpY1CjRyZ","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.x402stock.xyz","brandSlug":"agents-x402stock-xyz-x402","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"Returns a complete snapshot of one Hyperliquid on-chain perpetual futures market in a single call: live mark/oracle price, funding rate, open interest, funding history, L2 order book, and OHLCV candles.","exampleAgentPrompt":"Pull the full market overview for BTC perpetuals on Hyperliquid — I want the live mark price, oracle price, funding rate, open interest, order book, and recent candles all in one shot.","exampleUseCases":[{"title":"Live funding rate monitoring for BTC perps","prompt":"What is the current hourly funding rate and annualized funding APR for BTC perpetuals on Hyperliquid, and how has funding trended recently?"},{"title":"Order book depth check before entering ETH perp trade","prompt":"Show me the current L2 order book and mark price for ETH perpetuals on Hyperliquid so I can assess liquidity before placing a large position."},{"title":"OHLCV candle review for SOL perpetuals","prompt":"Get me the latest OHLCV candles and 24h volume for SOL perpetual futures on Hyperliquid — I want to see how price has moved today."}],"resultDescription":"A JSON object containing: (1) context section with live mark price, oracle price, mid price, funding rate (hourly and APR), open interest, premium, day volume in USD and base units, max leverage, and previous day price; (2) funding section with recent historical funding rate entries; (3) orderbook section with the current L2 bid/ask ladder; (4) candles section with OHLCV bars including open, high, low, close, volume, and trade count per interval. All sections degrade independently if one data source is temporarily unavailable. Metadata includes coin, venue (hyperliquid), source, and as_of timestamp.","failureModes":["Invalid or unsupported coin symbol returns an error or empty sections","Individual sections (funding, orderbook, candles) may return null if that data source is temporarily unavailable — sections degrade independently","Network timeout or Hyperliquid DEX downtime may cause partial or full failure","Rate limiting or payment failure via x402 returns a 402 Payment Required response","Coin symbols are case-sensitive; wrong casing may return no data"],"whenToPreferThis":"Use this endpoint when you need a comprehensive view of a single Hyperliquid perpetual market in one call — it replaces four separate calls (perps/{coin}, funding, orderbook, candles) at a lower combined cost of $0.03. Prefer this over individual endpoints when you need two or more of: live price/funding, order book, or candle data for the same coin. It is the right choice for trading bots, market monitoring agents, or dashboards that need a full market snapshot without assembling multiple API calls.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T12:41:25.734Z","isFirstParty":false,"canonicalSlug":"agents-x402stock-xyz-hyperliquid-perpetual-futures-market-overview-424a14ed"}