{"uid":"cap_WkJlqJnz9f9cSfYD7FzqD","slug":"x402stock-perpetual-futures-market-data-b5c91c5d","name":"x402stock Perpetual Futures Market Data","description":"Live state of every perpetual-futures market in one call: per coin the mark and oracle price, hourly funding rate with annualized APR, premium, open interest, max leverage, previous-day price, and 24h USD and base volume. Native crypto-derivatives data — funding and open interest are perp-only, absent from any spot feed. Free on-chain DEX data (venue: Hyperliquid), no key. From x402stock","url":"https://x402stock.vercel.app/api/v1/perps","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["source","as_of","venue","market","count","perps"],"properties":{"as_of":{"type":"string"},"count":{"type":"number"},"perps":{"type":"array","items":{"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}},"venue":{"type":"string"},"market":{"type":"string","const":"perp"},"source":{"type":"string","const":"x402stock"}},"additionalProperties":false}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_D0iWBiBXq9AuRg2KHdy_m","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns live per-coin perpetual futures market data including mark/oracle prices, funding rates, open interest, and 24h volume for all active perp markets on Hyperliquid","exampleAgentPrompt":"Pull the live snapshot of all perpetual futures markets on Hyperliquid — I want to see funding rates, open interest, mark and oracle prices, and 24h volume for every coin in one shot.","exampleUseCases":[{"title":"Funding rate arbitrage scanner","prompt":"Show me all the crypto perps on Hyperliquid right now with their annualized funding APR — I want to find which coins have the most extreme positive or negative funding rates so I can evaluate cash-and-carry trades."},{"title":"Portfolio risk dashboard for perp positions","prompt":"Fetch the current mark prices, oracle prices, and open interest for all perpetual futures on Hyperliquid — I'm monitoring my positions and need the latest market state."},{"title":"Crypto derivatives market overview","prompt":"Give me a full snapshot of every active perpetual futures market on Hyperliquid, including yesterday's price, today's 24h volume in USD, and the current funding rate for each coin."}],"resultDescription":"A JSON object containing a timestamped snapshot of all perpetual futures markets on Hyperliquid, with per-coin fields including: coin ticker, mark price, oracle price, mid price, previous day close, hourly funding rate, annualized funding APR (%), premium, open interest, max leverage, 24h volume in USD, and 24h volume in base currency. Also includes top-level metadata: source, venue, market type, timestamp, and total market count.","failureModes":["Hyperliquid API unavailability causes empty or stale data","Rate limiting or upstream timeout returns 5xx error","Payment of 0.02 USDC not processed results in 402 Payment Required","Individual coin fields may be null if data is temporarily unavailable for that market","Schema validation failure if upstream data format changes"],"whenToPreferThis":"Choose this endpoint when you need comprehensive perpetual futures data — especially funding rates and open interest — that is unavailable from spot market feeds. Ideal for derivatives traders, arbitrage monitors, and risk dashboards requiring live Hyperliquid perp state across all coins in a single call. Prefer over spot feeds when funding rate or leverage data is required, and over exchange-specific APIs when you want aggregated perp market state without managing exchange credentials.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:41:54.359Z","isFirstParty":false}