# Agent Desk API: Market State

> Agent Desk API: Market State is a paid API for AI agents from deskfeed.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-14).

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

## Facts

- Endpoint: GET https://deskfeed.dev/v1/market-state?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-desk-api-market-state-0e08fdca
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jM8Drg_UClzT6ylRxNe2U

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 agent-desk-api-market-state-0e08fdca
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## 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",
     "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"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-desk-api-market-state-0e08fdca/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from deskfeed.dev](https://www.zero.xyz/host/deskfeed.dev/llms.txt)