{"uid":"cap_cLyRAV6LNhw4h2dK4edrB","slug":"agentfeed-orderbook-imbalance-9e71daf2","name":"AgentFeed Orderbook Imbalance","description":"Orderbook imbalance for any USDT perp: resting bid and ask liquidity in USD within ±N bps of mid, the ratio between the two sides, and a skew read. Use when you need to answer: Which side of the book holds more resting liquidity?","url":"https://x402.ochinimus.app/api/orderbook-imbalance?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":{"bps":{"type":"number","description":"window ±bps around mid, 5-500, default 50"},"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":{"note":{"type":"string"},"skew":{"type":"string"},"symbol":{"type":"string"},"ask_usd":{"type":"number"},"bid_usd":{"type":"number"},"mid_price":{"type":"number"},"window_bps":{"type":"number"},"imbalance_ratio":{"type":"number"}}},"paid":{"type":"boolean"},"tool":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"data":{"note":"visible resting liquidity only — spoofable, read as context not signal","skew":"bid_heavy (support below)","symbol":"SOLUSDT","ask_usd":8430080,"bid_usd":12875007,"mid_price":121.455,"window_bps":50,"imbalance_ratio":1.527},"paid":true,"tool":"get_orderbook_imbalance"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ColMjK8Nt0taZbUOPHrqb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns resting bid/ask liquidity in USD within a configurable BPS window around mid-price for any USDT perpetual, plus the imbalance ratio and a directional skew label.","exampleAgentPrompt":"What's the orderbook imbalance on SOLUSDT right now — check within 50 bps of mid and tell me if it's bid-heavy or ask-heavy and by how much.","exampleUseCases":[{"title":"Pre-trade directional bias check","prompt":"Before I enter a long on ETHUSDT perp, can you check the orderbook imbalance within 100 bps of mid and tell me if there's meaningful bid support or if the book is ask-heavy?"},{"title":"Scalping setup for BTC perp","prompt":"Show me the current bid and ask liquidity in USD within 25 bps of mid on BTCUSDT and give me the imbalance ratio — I want to see if the book is skewed enough to favor a quick long."},{"title":"Cross-symbol market structure scan","prompt":"Compare the orderbook skew for SOLUSDT and XRPUSDT right now within 50 bps of mid — which one has stronger visible bid support?"}],"resultDescription":"Returns a JSON object with: the symbol, mid price, window in BPS, total bid-side USD and ask-side USD within that window, the ratio of bid to ask (imbalance_ratio), and a human-readable skew label (e.g. 'bid_heavy (support below)'). Includes a caveat that data reflects visible resting orders only and may be spoofed.","failureModes":["Invalid or unsupported symbol returns an error — only USDT perp pairs are supported","BPS value outside the 5–500 range may be rejected or clamped","Payment not settled (402 response) if x402 payment header is missing or rejected","Stale or missing exchange data may reduce accuracy of liquidity figures","Network timeouts possible during high-volatility periods"],"whenToPreferThis":"Use this endpoint when you need a fast, quantified snapshot of resting orderbook liquidity imbalance for a specific USDT perpetual — particularly when assessing directional bias, support/resistance context, or pre-trade market structure. Prefer it over raw exchange APIs when you want a normalized, multi-field summary (ratio + skew label + USD amounts) in a single call, paid per-use with no subscription required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T12:44:43.436Z","isFirstParty":false,"canonicalSlug":"agentfeed-orderbook-imbalance-9e71daf2"}