# ACODA Liquidation Intelligence Brief

> ACODA Liquidation Intelligence Brief is a paid API for AI agents from acoda.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns a real-time summary of liquidation events and position-level risk zones for a specified crypto perpetuals market

## Facts

- Endpoint: GET https://acoda.xyz/v1/agent/brief
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/acoda-liquidation-intelligence-brief-962900be
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_czXV94ypK7acPuYDBO7IT

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-liquidation-intelligence-brief-962900be
```

Example prompt: Give me ACODA's liquidation brief for BTC-USDT-PERP — I want to see the current mark price, funding direction, how many liquidations happened in the last hour and how big they were, and where the nearest liquidation zone sits.

## When to prefer this

Choose this endpoint when an AI trading agent needs a concise, actionable liquidation intelligence brief for major crypto perp markets without building its own data pipeline. It is ideal for pre-trade risk checks, real-time market regime assessment, or triggering alerts based on liquidation clusters. Prefer this over generic market data APIs when you specifically need liquidation zone mapping combined with funding rate context and recent liquidation volume in a single low-cost ($0.01/call) pay-per-call response.

## Known failure modes

- Invalid or unsupported market symbol — only BTC-USDT-PERP, ETH-USDT-PERP, SOL-USDT-PERP are accepted
- Payment not received — x402 payment flow must complete before data is returned
- Stale data if Hyperliquid feed is delayed or CEX liquidation sources are temporarily unavailable
- Rate limiting or upstream data unavailability during extreme market volatility

## 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: the queried market symbol, a human-readable summary string (mark price, funding direction, last-hour liquidation count and USD volume), and a nearest_zone object specifying side (long or short), price_low, and price_high of the closest concentrated liquidation cluster.

## 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",
  "summary": "BTC-USDT-PERP mark 63514. Funding positive (longs pay). Last hour: 14 liquidations totaling $4.9M.",
  "nearest_zone": {
   "side": "long",
   "price_low": 61800,
   "price_high": 62400
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/acoda-liquidation-intelligence-brief-962900be/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)