{"uid":"cap_Z9bDA5wmfQndkvpVorKAF","slug":"agents-x402stock-xyz-hyperliquid-perpetual-futures-market-state-by-coin-28d753fc","name":"Hyperliquid Perpetual Futures Market State by Coin","description":"Live state of one perpetual-futures market by coin (e.g. BTC, ETH, SOL): mark and oracle price, current hourly funding rate with annualized APR, premium, open interest, max leverage, previous-day price, and 24h USD and base volume. The single-coin read for funding and open-interest signals. Free on-chain DEX data (venue: Hyperliquid), no key. From x402stock","url":"https://agents.x402stock.xyz/api/v1/perps/{coin}","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":["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},"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_JuQT8-0DTGA_rIN6x33A1","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 perpetual-futures market data for a single coin on Hyperliquid DEX, including mark/oracle price, funding rate, open interest, volume, and max leverage.","exampleAgentPrompt":"What's the current funding rate and open interest for BTC perpetual futures on Hyperliquid right now, including the annualized APR?","exampleUseCases":[{"title":"Funding rate arbitrage signal check","prompt":"What's the current hourly funding rate and annualized APR for ETH perps on Hyperliquid? I want to see if there's a meaningful carry trade opportunity."},{"title":"Crypto perp liquidation risk assessment","prompt":"Pull up the live mark price, oracle price, and max leverage for SOL perpetual futures on Hyperliquid — I need to check how far the mark is from oracle before I open a position."},{"title":"Market activity monitoring for BTC","prompt":"Give me the 24-hour USD volume and open interest for BTC perps on Hyperliquid so I can gauge how liquid the market is right now."}],"resultDescription":"A JSON object containing the coin symbol, mark price, oracle price, mid price, previous day price, hourly funding rate, annualized funding APR, premium, open interest, max leverage, 24h USD volume, 24h base volume, the venue (Hyperliquid), market type (perp), and a timestamp for when the data was fetched.","failureModes":["Invalid or unsupported coin symbol returns an error — only coins listed on Hyperliquid perpetuals are valid","Hyperliquid DEX downtime or API unavailability may result in stale or missing data","Some fields (mark_price, oracle_price, funding_rate_hourly, etc.) may be null if the market is inactive or data is temporarily unavailable","Payment failure via x402 (insufficient USDC balance) prevents the request from completing"],"whenToPreferThis":"Use this endpoint when you need real-time perpetual futures market state for a specific coin on Hyperliquid, especially for funding rate signals, open interest analysis, or mark/oracle price divergence monitoring. It is the fastest single-coin read for on-chain perp data without requiring an API key. Prefer this over generic crypto price endpoints when funding rate, open interest, or leverage data is required. Best suited for agents doing DeFi strategy evaluation, carry trade monitoring, or liquidation risk assessment on Hyperliquid.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:47:16.652Z","isFirstParty":false}