{"uid":"cap_pYE-oZbs8kG86fDMiXndU","slug":"agentfeed-market-state-a4964a47","name":"AgentFeed Market State","description":"Market state for BTC, ETH, SOL or HYPE in one call: spot and the perp's basis against the Hyperliquid oracle, realized vol 7d and 30d, funding with its 30-day z-score, open interest and its changes, the top Hyperliquid accounts' net-long share, liquidations 1h and 24h by side, Fear and Greed, the next FOMC or CPI release, and flags with stated thresholds. Use when you need to answer: What is the…","url":"https://x402.ochinimus.app/api/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","required":[],"properties":{"symbol":{"type":"string","description":"BTC (default), ETH, SOL or HYPE"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"data":{"type":"object","properties":{"perp":{"type":"object"},"spot":{"type":"object"},"as_of":{"type":"string"},"flags":{"type":"array"},"symbol":{"type":"string"},"funding":{"type":"object"},"fear_greed":{"type":"object"},"flag_rules":{"type":"object"},"liquidations":{"type":"object"},"realized_vol":{"type":"object"},"open_interest":{"type":"object"},"next_macro_event":{"type":"object"},"whale_positioning":{"type":"object"}}},"paid":{"type":"boolean"},"tool":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"data":{"perp":{"as_of":"2026-10-13T04:50:33.…","source":"Hyperliquid perp mar…","basis_pct":-0.052,"mark_price":107.97,"basis_state":"backwardation (perp…"},"spot":{"as_of":"2026-10-13T04:50:33.…","value":107.876,"source":"on-chain DEX mid, me…"},"as_of":"2026-10-13T04:50:33.…","flags":["liq_spike_1h"],"symbol":"SOL","funding":{"as_of":"2026-10-13T04:47:53.…","source":"AgentFeed funding ra…","venues":{"hyperliquid":{"z_30d":0.16,"samples":720,"funding_rate_8h":0.00008525}},"max_abs_z":0.16},"fear_greed":{"as_of":"2026-10-13T00:00:00.…","value":57,"source":"alternative.me","classification":"Greed"},"flag_rules":{"liq_spike_1h":"last 60 minutes of l…","funding_extreme":"|z_30d| >= 2 on any…","event_within_24h":"the next FOMC decisi…"},"liquidations":{"as_of":"2026-10-13T04:35:00.…","source":"agentfeed_liq_tape (…","last_1h":{"longs_usd":0,"total_usd":435270,"shorts_usd":435270},"last_24h":{"longs_usd":38446657,"total_usd":40731662,"shorts_usd":2285005,"window_note":"clock-hour buckets t…"},"side_note":"longs_usd = longs li…","median_window_h":167,"hourly_median_usd":57429},"realized_vol":{"as_of":"2026-10-13T04:50:33.…","source":"Hyperliquid info API…","rv_7d_ann_pct":58.25,"rv_30d_ann_pct":62.6,"today_range_pct":6.14},"open_interest":{"as_of":"2026-10-13T04:50:33.…","source":"Hyperliquid open int…","mark_price":107.97,"change_1h_pct":null,"change_24h_pct":null,"hyperliquid_usd":626357741},"next_macro_event":{"utc":"2026-10-28T18:00:00.…","type":"FOMC","title":"FOMC rate decision (…","source_url":"https://www.federalr…","hours_to_go":373.2,"verified_at":"2026-10-12T05:23:01.…","date_new_york":"2026-10-28","time_new_york":"14:00","press_conference":true,"reference_period":null},"whale_positioning":{"as_of":"2026-10-13T04:50:10.…","covers":"the top 250 Hyperliq…","source":"Hyperliquid account…","long_usd":92194048.81,"short_usd":199325207.24,"long_accounts":11,"short_accounts":18,"net_long_share_pct":31.63}},"paid":true,"tool":"get_market_state"}},"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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3QUEDTR_xEu5Qckflbj89","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a comprehensive live crypto market snapshot for BTC, ETH, SOL, or HYPE including spot/perp prices, funding rates, liquidations, open interest, fear/greed index, realized/implied vol, long/short ratios, and upcoming macro events.","exampleAgentPrompt":"Give me the full live market state for SOL — I want to see spot price, perp basis, funding rates across exchanges, recent liquidations, the fear/greed index, long/short ratio, and any upcoming macro events that could move the market.","exampleUseCases":[{"title":"Pre-trade market conditions check","prompt":"Before I open a SOL long, can you pull the current market state — check the funding rate z-scores, whether there are any liquidation spike flags, and the long/short ratio so I know if I'm going against crowded positioning?"},{"title":"Daily crypto dashboard briefing","prompt":"Give me a morning briefing on BTC: spot and perp prices, whether we're in contango or backwardation, the fear and greed reading, realized vol over 7 and 30 days, and what the next big macro event is."},{"title":"Liquidation and volatility alert for ETH","prompt":"Check the live ETH market data for me — are there any active liquidation cascade flags, what's the realized vol versus implied vol spread, and how much has open interest changed in the last 24 hours?"}],"resultDescription":"A JSON object containing: spot price, perp mark price and basis percentage, per-venue funding rates with 30-day z-scores, fear/greed index with classification, long/short account ratios, liquidation totals for last 1h and 24h with cascade flags, realized vol (7d and 30d annualized), implied vol (if available), open interest across Bybit and OKX, next upcoming macro event (type, UTC time, source URL), active signal flags (e.g. liq_spike_1h, funding_extreme), and flag rule definitions. All fields include freshness timestamps.","failureModes":["Symbol not supported — only BTC, ETH, SOL, HYPE are valid; other values return an error","Payment not completed via x402 — returns 402 with payment details if USDC micropayment on Solana/Base/Polygon/Arbitrum is missing or insufficient","Implied vol field may be null if options snapshot is unavailable","Stale data warning on funding if upstream venue is lagging","Rate limiting or upstream data provider outage returning partial or empty fields"],"whenToPreferThis":"Choose this endpoint when you need a single aggregated market state snapshot for a top crypto asset (BTC, ETH, SOL, HYPE) that combines multiple data dimensions — funding rates, liquidations, open interest, volatility, sentiment — without having to call separate specialized endpoints. It is ideal for pre-trade analysis, market briefings, or agent decision-making workflows where a broad market context is needed in one call. Prefer specialized sibling endpoints (e.g. liquidation cascade detector, basis endpoint, long/short ratio) when you only need one specific data dimension or need to query an arbitrary USDT perp pair beyond the four supported symbols.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:38:42.208Z","isFirstParty":false,"canonicalSlug":"agentfeed-market-state-a4964a47"}