# CoinAnk Liquidation Rankings API

> CoinAnk Liquidation Rankings API is a paid API for AI agents from claw402.ai, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Retrieves ranked cryptocurrency liquidation data, sortable and paginated, via x402 micropayment gateway

## Facts

- Endpoint: GET https://claw402.ai/api/v1/coinank/rank/liquidation
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coinank-liquidation-rankings-api-37104bb6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Fn8CcjlydFYiWjSMqQbmE

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 coinank-liquidation-rankings-api-37104bb6
```

Example prompt: Show me the top 20 cryptocurrency liquidations right now, sorted by liquidation size in descending order — I want to see which assets are getting hit hardest.

## When to prefer this

Use this endpoint when you need ranked, paginated cryptocurrency liquidation data and want to pay per-call with USDC via x402 without API key registration. Prefer this over alternatives when building crypto market dashboards, monitoring forced liquidation events, or analyzing which assets are under the most liquidation pressure.

## Known failure modes

- Empty data array returned if no liquidation data available
- Invalid page or size parameters may return an error or empty result
- Payment failure via x402 if wallet lacks sufficient USDC
- Unsupported sortBy or sortType values may return an error or unordered results
- Upstream CoinAnk data unavailability may result in empty or stale response

## How this service works

Backed by vergex.trade. Pay for any API with USDC. No API keys. No registration. Just a wallet.

## Output

A JSON object with a code field (0 for success) and a data array containing ranked liquidation records for cryptocurrencies, ordered by the requested sort field and direction, for the requested page.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "page": "1",
   "size": "10",
   "sortBy": "liquidationAmount",
   "sortType": "desc"
  }
 }
}
```

## 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": {
      "page": {
       "type": "string"
      },
      "size": {
       "type": "string"
      },
      "sortBy": {
       "type": "string"
      },
      "sortType": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "code": 0,
  "data": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coinank-liquidation-rankings-api-37104bb6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from claw402.ai](https://www.zero.xyz/host/claw402.ai/llms.txt)