{"uid":"cap_XCCOCvx5qFxAYS00HX69Z","slug":"onchain-query-api-crypto-perpetual-futures-snapshot-811ea98e","name":"Onchain Query API – Crypto Perpetual Futures Snapshot","description":"Crypto perpetual-futures snapshot for a symbol in ONE call (Binance USD-M, keyless): current funding rate and the next funding time, mark and index price, open interest (contracts and USD), 24h price change/high/low/volume, and the top-trader long/short account ratio. For funding arbitrage, leverage/positioning reads, and a derivatives view an onchain-only feed cannot give. Cached 30s.","url":"https://chain.cyberwarex.com/derivatives","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","required":["symbol"],"properties":{"symbol":{"type":"string","description":"Asset ticker (BTC, ETH, SOL...) or a full perp symbol like BTCUSDT."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"perp":{"type":"string"},"source":{"type":"string"},"symbol":{"type":"string"},"low_24h":{"type":["number","null"]},"high_24h":{"type":["number","null"]},"mark_price":{"type":["number","null"]},"volume_24h":{"type":["number","null"]},"index_price":{"type":["number","null"]},"funding_rate":{"type":["number","null"]},"open_interest":{"type":["number","null"]},"long_short_ratio":{"type":["number","null"]},"next_funding_time":{"type":["integer","null"]},"open_interest_usd":{"type":["number","null"]},"price_change_24h_pct":{"type":["number","null"]},"funding_rate_annualized_pct":{"type":["number","null"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VYnYHkRBa_7QVv42oFmD6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a comprehensive perpetual-futures market snapshot for a given symbol from Binance USD-M, including funding rate, mark/index price, open interest, 24h stats, and long/short ratio — all in one call.","exampleAgentPrompt":"What's the current funding rate, mark price, open interest, and long/short ratio for BTC perpetual futures right now?","exampleUseCases":[{"title":"Funding arbitrage opportunity scan","prompt":"Check the current funding rate and annualized funding rate for ETH perp — I want to know if it's worth running a cash-and-carry trade right now."},{"title":"Derivatives positioning dashboard","prompt":"Pull me a full perp snapshot for SOL — I need the open interest in USD, the long/short ratio, and the 24h volume to gauge how traders are positioned."},{"title":"Next funding time alert setup","prompt":"When is the next funding time for BTC perpetual futures, and what is the current funding rate? I want to decide whether to hold my position through it."}],"resultDescription":"A JSON object containing: the perpetual symbol, funding rate, annualized funding rate percentage, next funding timestamp (Unix ms), mark price, index price, open interest in contracts and USD, 24h high/low/volume and price change percent, and the top-trader long/short account ratio. Data is sourced from Binance USD-M and cached for 30 seconds.","failureModes":["Unknown or unsupported symbol returns null fields or an error","Symbol not available on Binance USD-M returns empty or null data","Network/cache timeout may return stale data beyond the 30s cache window","Malformed symbol input (e.g. wrong format) may return an error response","Payment failure (x402) if USDC balance is insufficient"],"whenToPreferThis":"Choose this endpoint when you need a one-call, aggregated derivatives view for a crypto asset — especially when you need funding rate, open interest, and long/short ratio together without assembling multiple Binance API calls. Ideal for funding arbitrage decisions, leverage/positioning reads, or when onchain-only data sources lack derivatives coverage.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:40:07.410Z","isFirstParty":false}