# AgentFeed Market State

> AgentFeed Market State is a paid API for AI agents from x402.ochinimus.app, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-16).

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.

## Facts

- Endpoint: GET https://x402.ochinimus.app/api/market-state?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentfeed-market-state-a4964a47
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pYE-oZbs8kG86fDMiXndU

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentfeed-market-state-a4964a47
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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…

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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_shar
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentfeed-market-state-a4964a47/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.ochinimus.app](https://www.zero.xyz/host/x402.ochinimus.app/llms.txt)