{"uid":"cap_T-A6c9Jq2tqJe0nlfmjFD","slug":"x402stock-perpetuals-overview-api-cb3d3406","name":"x402stock Perpetuals Overview API","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/perps/overview/%7Bcoin%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"coin":"BTC","as_of":"2026-06-04T12:00:00.000Z","venue":"hyperliquid","source":"x402stock","candles":{"coin":"BTC","as_of":"2026-06-04T00:00:00.000Z","count":1,"venue":"hyperliquid","source":"x402stock","candles":[{"end":"2026-06-01T00:59:59.999Z","low":71218,"high":71589,"open":71413,"close":71411,"start":"2026-06-01T00:00:00.000Z","trades":17583,"volume":3376.8}],"interval":"1h"},"context":{"data":{"coin":"BTC","premium":-0.0003457543,"mid_price":63606.5,"mark_price":63606,"max_leverage":40,"oracle_price":63629,"open_interest":31304.105,"day_volume_usd":6772680481.63,"prev_day_price":64583,"day_volume_base":106799.6,"funding_apr_percent":10.95,"funding_rate_hourly":0.0000125},"as_of":"2026-06-04T00:00:00.000Z","venue":"hyperliquid","market":"perp","source":"x402stock"},"funding":{"coin":"BTC","as_of":"2026-06-04T00:00:00.000Z","count":1,"venue":"hyperliquid","source":"x402stock","history":[{"time":"2026-06-03T00:00:00.000Z","premium":-0.0003727867,"funding_apr_percent":10.95,"funding_rate_hourly":0.0000125}]},"sections":{"candles":"ok","context":"ok","funding":"ok","orderbook":"ok"},"orderbook":{"asks":[{"size":5.04588,"price":63591,"orders":12}],"bids":[{"size":4.1275,"price":63590,"orders":10}],"coin":"BTC","as_of":"2026-06-04T00:00:00.000Z","venue":"hyperliquid","source":"x402stock"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cB-2te4224l1CFkVD1oPp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a comprehensive overview of on-chain perpetuals data for a given coin, including candles, funding rates, order book, and market context from Hyperliquid.","exampleAgentPrompt":"What's the current funding rate, open interest, mark price, and order book snapshot for BTC perpetuals on Hyperliquid right now?","exampleUseCases":[{"title":"Funding rate arbitrage research","prompt":"Can you pull the funding APR and hourly funding rate for ETH perpetuals on Hyperliquid? I want to see if there's an arbitrage opportunity between the funding rate and spot markets right now."},{"title":"On-chain perp market snapshot","prompt":"Give me a full snapshot of SOL perpetuals on Hyperliquid — I need the mark price, oracle price, open interest, day volume, and the top bids and asks from the order book."},{"title":"DeFi trading candles analysis","prompt":"Show me the latest OHLCV candles for BTC perps on Hyperliquid along with the current premium and max leverage available — I'm trying to gauge short-term price momentum."}],"resultDescription":"A JSON object containing: current candles (OHLCV with trade count and volume), market context (mark price, oracle price, mid price, open interest, funding rate hourly, funding APR, day volume in USD, max leverage, premium), funding rate history, and order book (top bids and asks with size and order count), all timestamped and sourced from Hyperliquid.","failureModes":["Invalid or unsupported coin symbol returns an error or empty result","Payment failure via x402 if USDC balance is insufficient","Hyperliquid data unavailability causes partial section failures (sections field shows errors)","Network timeout if Hyperliquid API is slow","Coin not listed on Hyperliquid perps market returns not found"],"whenToPreferThis":"Use this endpoint when you need a comprehensive on-chain perpetuals snapshot for a specific coin — combining candles, funding rates, order book, and market context in a single call. Prefer this over spot price APIs when you need derivatives-specific data like funding rate, open interest, or leverage. Ideal for DeFi trading analytics, funding rate arbitrage research, or on-chain perp monitoring without needing an API key.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-12T06:42:07.499Z","isFirstParty":false}