{"uid":"cap_pUd1klTP8ydpXcoUZMQfA","slug":"agent402-perpetual-markets-data-cc1516b8","name":"Agent402 Perpetual Markets Data","description":"Every listed perpetual futures market in one call: mark, oracle and mid price, 24-hour change, funding (hourly, 8-hour, annualized), open interest in coins and dollars, 24-hour notional volume and max leverage, sortable by volume, open interest, funding or change. Use it as the one-shot market map before drilling into a single symbol.","url":"https://agent402.tools/api/perp-markets","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sort":{"type":"string","description":"volume (default), openInterest, funding, change, or coin."},"coins":{"type":"string","description":"Optional comma-separated coin filter (e.g. \"BTC,ETH,SOL\")."},"limit":{"type":"number","description":"Rows to return (default 50, max 500)."}}},"responseSchema":{"type":"json","example":{"sort":"volume","count":2,"source":"hyperliquid","markets":[{"coin":"BTC","markPx":77267,"oraclePx":77236,"funding8h":0.0001,"premiumPct":0.0388,"maxLeverage":40,"change24hPct":0.39,"openInterest":35935.67,"volume24hUsd":4679441788.67,"fundingAprPct":10.95,"fundingHourly":0.0000125,"openInterestUsd":2776803000}],"fetchedAt":"2026-08-22T12:00:00.000Z","totalMarkets":230}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_w2laYIRqnF817qdxYKH4c","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns live perpetual futures market data (price, funding, open interest, volume, leverage) from Hyperliquid, with optional coin filtering and sorting.","exampleAgentPrompt":"Pull the top 20 perp markets from Hyperliquid sorted by open interest, and filter it down to just BTC, ETH, and SOL — I want to see funding rates, mark price, and 24h volume.","exampleUseCases":[{"title":"Funding rate arbitrage scanner","prompt":"Show me all perp markets sorted by funding rate so I can find the ones with the most extreme positive or negative funding — I want the full list up to 500 markets."},{"title":"BTC and ETH perp market snapshot","prompt":"Give me the latest perpetual market data for just BTC and ETH — I need mark price, oracle price, 24h volume, open interest, and the current funding APR."},{"title":"Most active perp markets by volume","prompt":"What are the top 10 most actively traded perp markets right now sorted by 24h volume? I want to see funding and open interest too."}],"resultDescription":"A JSON object containing a list of perpetual market records sourced from Hyperliquid, each with coin symbol, mark price, oracle price, 8h funding rate, funding APR (annualized), hourly funding rate, premium percent, max leverage, 24h price change percent, open interest (raw and USD), and 24h volume in USD. Also includes total market count, sort field used, data source, and fetch timestamp.","failureModes":["Invalid sort field returns an error or defaults to volume","Invalid coin symbols in filter may return empty markets array","Limit exceeding 500 may be capped or rejected","Hyperliquid data source downtime causes fetch failure or stale data","Malformed request body returns 400-level error"],"whenToPreferThis":"Choose this endpoint when you need live perpetual futures market data — especially funding rates, open interest, and volume — from Hyperliquid without requiring an API key or account. It is ideal for agents monitoring DeFi derivatives markets, scanning for funding rate opportunities, or building dashboards over Hyperliquid perp data with flexible coin filtering and sorting.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:46:39.558Z","isFirstParty":false}