{
  "x402Version": 2,
  "id": 42420,
  "slug": "42420",
  "resource": "https://x402-tools-production-2755.up.railway.app/tools/liquidations",
  "description": "Use before opening, sizing or hedging a Hyperliquid perp to see where leveraged positions get liquidated. Liquidation levels for one coin, bucketed by price, from the open positions of the most active accounts (measured, not modelled): volume within 5%/10% of the mark, biggest clusters, largest positions, open-interest coverage.",
  "type": "http",
  "serviceName": "x402 tools",
  "resourceType": "Market Data",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0xef7674f50f84e9b9a89af9dc40ffea56edf67d6c",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "20000",
      "amountUsd": 0.02,
      "maxTimeoutSeconds": 120
    }
  ],
  "outputSchema": {
    "properties": {
      "example": {
        "type": "object"
      },
      "type": {
        "type": "string"
      }
    },
    "required": [
      "type"
    ],
    "type": "object"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "method": "GET",
          "queryParams": {
            "coin": "BTC",
            "range_pct": "10"
          },
          "type": "http"
        },
        "output": {
          "example": {
            "bucketPct": 0.5,
            "coin": "BTC",
            "coverageOfOpenInterestPct": 19,
            "dataAgeSeconds": 95,
            "dataAsOf": "2026-09-30T03:20:00.000Z",
            "levels": [
              {
                "longLiquidationsUsd": 9800000,
                "pctFromMark": [
                  -3,
                  -2.5
                ],
                "positions": 14,
                "priceHigh": 81278,
                "priceLow": 80861,
                "shortLiquidationsUsd": 0
              }
            ],
            "markPrice": 83362,
            "rangePct": 10,
            "summary": {
              "largestClusterAbove": null,
              "largestClusterBelow": {
                "longLiquidationsUsd": 9800000,
                "pctFromMark": [
                  -3,
                  -2.5
                ],
                "positions": 14,
                "priceHigh": 81278,
                "priceLow": 80861,
                "shortLiquidationsUsd": 0
              },
              "longLiquidationsWithin10PctUsd": 136713648,
              "longLiquidationsWithin5PctUsd": 55173698,
              "shortLiquidationsWithin10PctUsd": 57360684,
              "shortLiquidationsWithin5PctUsd": 50163208
            },
            "walletsWithPositions": 520
          },
          "type": "json"
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "additionalProperties": false,
            "properties": {
              "method": {
                "enum": [
                  "GET"
                ],
                "type": "string"
              },
              "queryParams": {
                "properties": {
                  "bucket_pct": {
                    "description": "Price bucket width in %, 0.1-5, default 0.5",
                    "type": "string"
                  },
                  "coin": {
                    "description": "Hyperliquid perp name, e.g. BTC, ETH, SOL, HYPE, kPEPE (case-insensitive). See /tools/liquidations/coverage",
                    "type": "string"
                  },
                  "range_pct": {
                    "description": "Only levels within this % of the mark price, 1-50, default 20",
                    "type": "string"
                  }
                },
                "required": [
                  "coin"
                ],
                "type": "object"
              },
              "type": {
                "const": "http",
                "type": "string"
              }
            },
            "required": [
              "type",
              "method"
            ],
            "type": "object"
          },
          "output": {
            "properties": {
              "example": {
                "type": "object"
              },
              "type": {
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          }
        },
        "required": [
          "input"
        ],
        "type": "object"
      }
    }
  },
  "tags": [
    "bazaar"
  ],
  "sourceHost": "x402-tools-production-2755.up.railway.app",
  "lastUpdated": "2026-10-08T06:09:57.383Z",
  "quality": {
    "calls30d": 2,
    "uniquePayers30d": 2,
    "lastCalledAt": "2026-10-08T06:09:57.194Z"
  },
  "metadata": {
    "serviceName": "x402 tools",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "method": "GET",
            "queryParams": {
              "coin": "BTC",
              "range_pct": "10"
            },
            "type": "http"
          },
          "output": {
            "example": {
              "bucketPct": 0.5,
              "coin": "BTC",
              "coverageOfOpenInterestPct": 19,
              "dataAgeSeconds": 95,
              "dataAsOf": "2026-09-30T03:20:00.000Z",
              "levels": [
                {
                  "longLiquidationsUsd": 9800000,
                  "pctFromMark": [
                    -3,
                    -2.5
                  ],
                  "positions": 14,
                  "priceHigh": 81278,
                  "priceLow": 80861,
                  "shortLiquidationsUsd": 0
                }
              ],
              "markPrice": 83362,
              "rangePct": 10,
              "summary": {
                "largestClusterAbove": null,
                "largestClusterBelow": {
                  "longLiquidationsUsd": 9800000,
                  "pctFromMark": [
                    -3,
                    -2.5
                  ],
                  "positions": 14,
                  "priceHigh": 81278,
                  "priceLow": 80861,
                  "shortLiquidationsUsd": 0
                },
                "longLiquidationsWithin10PctUsd": 136713648,
                "longLiquidationsWithin5PctUsd": 55173698,
                "shortLiquidationsWithin10PctUsd": 57360684,
                "shortLiquidationsWithin5PctUsd": 50163208
              },
              "walletsWithPositions": 520
            },
            "type": "json"
          }
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "properties": {
            "input": {
              "additionalProperties": false,
              "properties": {
                "method": {
                  "enum": [
                    "GET"
                  ],
                  "type": "string"
                },
                "queryParams": {
                  "properties": {
                    "bucket_pct": {
                      "description": "Price bucket width in %, 0.1-5, default 0.5",
                      "type": "string"
                    },
                    "coin": {
                      "description": "Hyperliquid perp name, e.g. BTC, ETH, SOL, HYPE, kPEPE (case-insensitive). See /tools/liquidations/coverage",
                      "type": "string"
                    },
                    "range_pct": {
                      "description": "Only levels within this % of the mark price, 1-50, default 20",
                      "type": "string"
                    }
                  },
                  "required": [
                    "coin"
                  ],
                  "type": "object"
                },
                "type": {
                  "const": "http",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "method"
              ],
              "type": "object"
            },
            "output": {
              "properties": {
                "example": {
                  "type": "object"
                },
                "type": {
                  "type": "string"
                }
              },
              "required": [
                "type"
              ],
              "type": "object"
            }
          },
          "required": [
            "input"
          ],
          "type": "object"
        }
      }
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": false,
  "featured": false,
  "provider": {
    "host": "x402-tools-production-2755.up.railway.app",
    "manifest_name": "x402-tools-production-2755.up.railway.app",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-10-14T01:15:01.050Z"
  },
  "exampleResponse": {
    "example": {},
    "type": "string"
  }
}