{"uid":"cap_jM8Drg_UClzT6ylRxNe2U","slug":"agent-desk-api-market-state-0e08fdca","name":"Agent Desk API: Market State","description":"Multi-timeframe market state for BTCUSDT, ETHUSDT, SOLUSDT, XRPUSDT & DOGEUSDT USD-M perpetual futures in one call: mark & index price, funding rate, open interest change, taker buy share, per-timeframe (4h/1h/15m) EMA-20/50, RSI-14, ATR and prior 20-bar high/low. Structured for trading agents needing clean market context. Descriptive data only — not financial advice. Refreshed every 15 min; data age disclosed in every response.","url":"https://deskfeed.dev/v1/market-state?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","properties":{"symbol":{"enum":["BTCUSDT","ETHUSDT","SOLUSDT","XRPUSDT","DOGEUSDT","ALL"],"type":"string","default":"BTCUSDT","description":"Futures symbol; ALL returns every covered symbol"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["as_of","data_age_seconds","source","symbols","disclaimer"],"properties":{"as_of":{"type":"string","description":"Observation time (ISO 8601 UTC)"},"source":{"type":"string","description":"Data source description"},"symbols":{"type":"object","description":"Selected symbol → metrics (key = symbol)"},"disclaimer":{"type":"string","description":"Informational-use notice"},"data_age_seconds":{"type":"integer","description":"Age of upstream data in seconds"}}}}}}},"responseSchema":null,"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_HbkLSkHngTCVP0TZb8rt9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns multi-timeframe market state (mark price, funding rate, open interest, taker buy share, EMAs) for BTCUSDT and/or ETHUSDT USD-M perpetual futures in a single call","exampleAgentPrompt":"Give me the full multi-timeframe market state for BTCUSDT perpetuals — I want the current mark price, funding rate, open interest change, taker buy share, and the 4h/1h/15m EMA readings all in one shot.","exampleUseCases":[{"title":"Pre-trade directional bias check","prompt":"Before I place a BTC perp trade, pull the current market state for BTCUSDT — I want to see funding rate, open interest change, and the EMA-20 across the 4h, 1h, and 15m timeframes to gauge directional bias."},{"title":"ETH derivatives health monitor","prompt":"Check the current market state for ETHUSDT perpetuals — give me the mark price, index price, funding rate, and taker buy share so I can see if ETH perps are in a healthy or stressed state."},{"title":"Combined BTC and ETH snapshot for dashboard","prompt":"Fetch the full market state for both BTC and ETH perp futures at once — I need the funding rates, open interest changes, taker buy ratios, and all timeframe EMAs for my trading dashboard."}],"resultDescription":"A structured snapshot of USD-M perpetual futures market conditions for the requested symbol(s), including mark price, index price, current funding rate, open interest change, taker buy share (aggressor ratio), and per-timeframe (4h, 1h, 15m) EMA-20 and related technical indicators — all returned in a single response.","failureModes":["Invalid symbol value (not BTCUSDT, ETHUSDT, or ALL) returns a validation error","Upstream exchange data unavailable causes stale or error response","Payment not settled via x402 protocol results in 402 Payment Required","Rate limiting may occur under high-frequency polling","Network timeout if exchange feed is delayed"],"whenToPreferThis":"Choose this endpoint when an agent needs a comprehensive, multi-timeframe derivatives market snapshot for BTC or ETH perpetuals in a single API call rather than assembling individual data points from multiple sources. It is especially valuable for trading agents that need funding rate, open interest, taker aggression, and EMA technicals simultaneously for signal generation or pre-trade analysis. Prefer it over generic exchange REST APIs when you want a pre-aggregated, agent-ready payload without the complexity of raw exchange integration.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T06:30:46.719Z","isFirstParty":false,"canonicalSlug":"agent-desk-api-market-state-0e08fdca"}