# ACODA Market State — CEX Liquidation & Hyperliquid Perp Intelligence

> ACODA Market State — CEX Liquidation & Hyperliquid Perp Intelligence is a paid API for AI agents from acoda.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns real-time perp market state including mark price, funding rate, open interest, and multi-exchange liquidation data for BTC, ETH, or SOL perpetual markets

## Facts

- Endpoint: GET https://acoda.xyz/v1/market-state
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/acoda-market-state-cex-liquidation-hyperliquid-perp-intelligence-85cc02d6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__BFCqxAp0GsyX3xjwQ00r

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 acoda-market-state-cex-liquidation-hyperliquid-perp-intelligence-85cc02d6
```

Example prompt: Pull the current market state for BTC-USDT-PERP — I want the mark price, funding rate, open interest, and how fresh the data is.

## When to prefer this

Choose this endpoint when your AI trading agent needs a single, aggregated view of perpetual market state that combines transparent on-chain Hyperliquid position data with CEX liquidation signals. It is ideal for pre-trade checks, position sizing decisions, funding rate arbitrage signals, or real-time market monitoring workflows. Prefer it over raw exchange APIs when you want pre-normalized, multi-source mark price and open interest data in one pay-per-call call without managing multiple WebSocket connections.

## Known failure modes

- Invalid or unsupported market symbol returns an error — only BTC-USDT-PERP, ETH-USDT-PERP, SOL-USDT-PERP are accepted
- Payment not included or insufficient USDC (x402 flow) results in 402 Payment Required
- Stale data flag (stale: true) may be returned if upstream Hyperliquid or CEX feeds are delayed
- Network timeout if the aggregation layer is slow to collect multi-exchange data
- Rate limiting if too many calls are made in rapid succession without proper payment

## How this service works

Measured liquidation intelligence combining observed CEX liquidation events with position-level data from Hyperliquid, the largest transparent perp venue. A pay-per-call JSON API for AI trading agents.

## Output

A JSON object containing: payment confirmation (paid: true), the queried market symbol, data freshness metadata (stale flag and age in milliseconds), current mark price in USD, funding rate, total open interest in USD, and an exchange breakdown showing each CEX's contribution weight and mark price (e.g. Binance at 0.32 weight).

## 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": {
      "market": {
       "enum": [
        "BTC-USDT-PERP",
        "ETH-USDT-PERP",
        "SOL-USDT-PERP"
       ],
       "type": "string",
       "description": "Perp market (canonical BASE-QUOTE-PERP)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "paid": true,
  "market": "BTC-USDT-PERP",
  "freshness": {
   "stale": false,
   "age_ms": 426
  },
  "mark_price": 63514.07,
  "funding_rate": 0.0000759,
  "open_interest_usd": 21441257752.13,
  "exchange_breakdown": {
   "binance": {
    "weight": 0.32,
    "markPrice": 63514.77
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/acoda-market-state-cex-liquidation-hyperliquid-perp-intelligence-85cc02d6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from acoda.xyz](https://www.zero.xyz/host/acoda.xyz/llms.txt)