Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Agent Desk Market State API
version: 0.6.0
description: Machine-payable crypto market data for agents (deskfeed.dev). Calls are settled per request in USDC on Base via x402 (HTTP 402). Descriptive market data for informational purposes only. Not financial advice.
servers:
- url: https://deskfeed.dev
tags:
- name: Market State
paths:
/v1/market-state:
get:
operationId: market-state
summary: '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.'
parameters:
- name: symbol
in: query
required: false
schema:
type: string
enum:
- BTCUSDT
- ETHUSDT
- SOLUSDT
- XRPUSDT
- DOGEUSDT
- ALL
default: BTCUSDT
description: Futures symbol; ALL returns every covered symbol
responses:
'200':
description: Paid response
content:
application/json:
schema:
type: object
'402':
description: Payment required (x402 challenge in PAYMENT-REQUIRED header)
x-x402:
scheme: exact
price: $0.01
network: eip155:8453
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
assetName: USDC
note: Payment requirements are authoritative in the live 402 response.
tags:
- Market State