{"uid":"cap_eJRpX0hYH7Ha-70SIB6Rt","slug":"ai-rook-order-flow-analysis-d1013f02","name":"AI Rook Order Flow Analysis","description":"Order flow snapshot — CVD, OI, whale CVD, session levels, proximity to key levels, volume gear ratio. Live from rook-engine MMT WebSocket feed","url":"https://agents.ai-rook.com/api/order-flow","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","properties":{"bars":{"type":"integer","default":100,"maximum":500,"minimum":1},"symbol":{"type":"string","default":"BTCUSDT"},"timeframe":{"enum":["1m","5m","15m","1h","4h"],"type":"string","default":"15m"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"oi":{"value":8900000000,"direction":"up"},"cvd":{"value":1240000,"direction":"up"},"gear":"high","symbol":"BTCUSDT","timestamp":"2026-07-22T07:00:00Z","whale_cvd":"bullish","volume_ratio":1.8}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.125","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.125/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.125","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.125","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Jnci3Q2kX2c08-ju4ZKYu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.125","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches real-time crypto order flow data including open interest, cumulative volume delta (CVD), whale CVD sentiment, volume ratio, and market gear for a given trading pair and timeframe","exampleAgentPrompt":"Pull the current order flow for BTCUSDT on the 15-minute timeframe — I want to see open interest direction, CVD, whale sentiment, volume ratio, and whether the market is in high or low gear.","exampleUseCases":[{"title":"Real-time whale activity tracking for BTC","prompt":"Check the whale CVD sentiment for BTCUSDT right now — I need to know if the smart money is accumulating or distributing, and what the overall order flow direction looks like on the 1-hour chart."},{"title":"Volume gear and momentum confirmation signal","prompt":"Give me a quick snapshot of the order flow for ETHUSDT on the 4-hour timeframe — specifically the volume ratio, market gear status, and whether the cumulative volume delta is supporting the current move or showing weakness."},{"title":"Open interest analysis for position sizing","prompt":"Pull the latest order flow data for BTCUSDT — I want to see if open interest is building or declining, what the CVD is telling us, and whether we're near any key session levels that could matter for my next trade."}],"resultDescription":"Returns a JSON object with open interest value and direction (up/down), CVD value and direction, whale CVD sentiment (bullish/bearish), volume ratio, market gear (high/low), trading symbol, and UTC timestamp — all reflecting real-time market microstructure conditions.","failureModes":["Invalid symbol returns error (only supported pairs accepted)","Timeframe not in enum [1m,5m,15m,1h,4h] returns 422 validation error","Bars value outside 1-500 range rejected","Insufficient USDC balance or failed x402 payment returns 402","Network or exchange data feed outage may return 503 or stale data","Base mainnet transaction failure blocks the call"],"whenToPreferThis":"Use this endpoint when an AI trading agent needs real-time order flow intelligence — specifically open interest, CVD, whale activity, and volume ratio — for BTCUSDT or other supported crypto pairs. Prefer this over generic OHLCV or price endpoints when microstructure signals (who is driving price, institutional vs retail flow) matter. Best for momentum-based or flow-based trading strategies requiring a live snapshot without needing historical data storage.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:46:33.664Z","isFirstParty":false}