{"uid":"cap_Je4KS-AXvUHxc3uXua3BR","slug":"agentfeed-perp-market-data-6a8be100","name":"AgentFeed Perp Market Data","description":"Perp market data for one USDT perp in a single call: cross-venue funding (Bybit, OKX, Hyperliquid), open interest with 1h/24h change, long/short ratio, and 24h liquidations with long/short split and biggest print from our own tape. Use when you need to answer: What is this perp doing right now, in one call?","url":"https://x402.ochinimus.app/api/perp?utm_source=zero.xyz","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"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"symbol":{"type":"string","description":"USDT perp symbol e.g. SOLUSDT, BTCUSDT (default SOLUSDT)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"data":{"type":"object","properties":{"source":{"type":"string"},"symbol":{"type":"string"},"funding":{"type":"object"},"partial":{},"tape_age_sec":{"type":"number"},"open_interest":{"type":"object"},"liquidations_24h":{"type":"object"}}},"paid":{"type":"boolean"},"tool":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"data":{"source":"bybit+okx+hyperliquid venues, liquidations from our own tape","symbol":"SOLUSDT","funding":{"venues":{"okx":{"mark_price":118.19,"funding_rate_8h":0.0000384889726373,"funding_rate_raw":0.0000384889726373,"next_funding_time":1790611200000,"funding_interval_hours":8},"bybit":{"mark_price":118.209,"funding_rate_8h":0.00008784,"funding_rate_raw":0.00008784,"next_funding_time":1790611200000,"funding_interval_hours":8},"hyperliquid":{"mark_price":118.31,"funding_rate_1h":0.0000125,"funding_rate_raw":0.0000125,"funding_rate_8h_equiv":0.0001,"funding_interval_hours":1}},"crowding":"longs_pay_everywhere","spread_8h":0.00006151},"partial":null,"long_short":{"source":"bybit_v5_public","long_pct":68.82,"short_pct":31.18,"long_pct_1h_ago":68.79,"long_pct_24h_ago":67.29},"tape_age_sec":4,"open_interest":{"okx":{"oi_usd":360200963,"oi_base":3046096.940000001},"bybit":{"oi_usd":822567812,"oi_base":6961018.5,"change_1h_pct":0.36,"change_24h_pct":-4.74},"mark_price":118.209},"liquidations_24h":{"prints":1652,"venues":3,"longs_usd":10578854.85,"total_usd":12370870.62,"shorts_usd":1792015.77,"dominant_side":"longs","biggest_print_usd":603093.97}},"paid":true,"tool":"get_perp"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0025","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_hxVQ_IZ7t1oS4baQPrT_C","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns comprehensive perpetual futures data for a single symbol including cross-venue funding rates, open interest with change metrics, long/short ratios, and 24h liquidation data with biggest print.","exampleAgentPrompt":"Pull up the full perp market data for SOLUSDT — I need funding rates across Bybit, OKX, and Hyperliquid, the current open interest with 1h and 24h changes, the long/short ratio, and today's liquidation breakdown including the biggest single print.","exampleUseCases":[{"title":"Pre-trade funding rate check","prompt":"Before I open a long on SOL perps, can you check the current funding rates across Bybit, OKX, and Hyperliquid for SOLUSDT and tell me if they're elevated or negative?"},{"title":"Liquidation cascade monitoring","prompt":"I think there's a squeeze happening in BTC — can you pull the 24h liquidations for BTCUSDT perp, show me the long vs short split, and tell me what the biggest single liquidation print was?"},{"title":"Open interest trend analysis","prompt":"Check the open interest for ETHUSDT perps and tell me how much it's changed in the last hour and last 24 hours — I want to know if money is flowing in or out of the market."}],"resultDescription":"Returns a JSON object with the queried symbol, cross-venue funding rates (Bybit, OKX, Hyperliquid), open interest with 1h and 24h percentage changes, long/short account ratio, 24h liquidation totals split by long and short side, the largest single liquidation print from the proprietary tape, and tape age in seconds indicating data freshness. Also includes a partial flag if some venue data was unavailable.","failureModes":["Invalid symbol returns error or empty data — use standard USDT perp format like SOLUSDT or BTCUSDT","Tape data may be stale if tape_age_sec is high, indicating delayed liquidation feed","Partial flag set to true when one or more venues are temporarily unavailable, resulting in incomplete funding rate coverage","Payment failure (HTTP 402) if USDC balance is insufficient for the $0.001 per call fee","Rate limiting or timeout if upstream venue APIs are unresponsive"],"whenToPreferThis":"Choose this endpoint when you need a comprehensive, single-call perp market snapshot for one symbol that aggregates funding rates across Bybit, OKX, and Hyperliquid simultaneously, rather than making separate calls per venue. Ideal when an agent needs to evaluate funding rate arbitrage opportunities, assess market sentiment via long/short ratios, or understand liquidation pressure — all in one atomic request. Prefer sibling endpoints if you only need long/short ratio alone, liquidation tape alone, or a spot price without derivatives data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T06:42:56.224Z","isFirstParty":false,"canonicalSlug":"agentfeed-perp-market-data-6a8be100"}