ToolVet
77trust / 100

Tools Liquidations

by x402 tools in Documents & files

x402 APIPassing, checked 3 h ago

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.

GET https://x402-tools-production-2755.up.railway.app/tools/liquidations

Last 30 days

All checks passedSome failedAll failedNot checked
Uptime
100%
Response time
340 ms typical, 405 ms slowest 5%
Last check
3 h ago
Next check
any minute now

How to call it

GET https://x402-tools-production-2755.up.railway.app/tools/liquidations

Each call costs $0.02 in USDC on Base, paid with the request over x402.

Run a free test callOne unpaid request, the way an agent sends it. You see the payment challenge it gets back. Nothing is charged.

Example request

From the listing.

GET https://x402-tools-production-2755.up.railway.app/tools/liquidations?coin=BTC&range_pct=10

Parameters

ParameterTypeRequiredDescription
bucket_pctstringNoPrice bucket width in %, 0.1-5, default 0.5
coinstringYesHyperliquid perp name, e.g. BTC, ETH, SOL, HYPE, kPEPE (case-insensitive). See /tools/liquidations/coverage
range_pctstringNoOnly levels within this % of the mark price, 1-50, default 20

Example response

The provider's example. We can't check it without paying.

Example response, 41 lines
{
  "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
}

Call it from code

The curl command shows the payment challenge. The JavaScript and Python versions pay and call, and never pay more than $0.02.

curl: see the payment challenge
# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i 'https://x402-tools-production-2755.up.railway.app/tools/liquidations?coin=BTC&range_pct=10'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - 'https://x402-tools-production-2755.up.railway.app/tools/liquidations?coin=BTC&range_pct=10' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode
JavaScript: pay and call
// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.02 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.02" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.02 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fx402-tools-production-2755.up.railway.app%2Ftools%2Fliquidations
const res = await pay("https://x402-tools-production-2755.up.railway.app/tools/liquidations?coin=BTC&range_pct=10");
console.log(res.status, await res.text());
Python: pay and call
# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.02 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.02"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.get("https://x402-tools-production-2755.up.railway.app/tools/liquidations?coin=BTC&range_pct=10")
    print(res.status_code, res.text)

Security scan

  • No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
3 h agoPassed402405 ms$0.02
7 h agoPassed402340 ms$0.02
11 h agoPassed402361 ms$0.02
15 h agoPassed402335 ms$0.02
19 h agoPassed402336 ms$0.02
23 h agoPassed402397 ms$0.02
26 h agoPassed402352 ms$0.02
30 h agoPassed402338 ms$0.02
33 h agoPassed402334 ms$0.02
37 h agoPassed402367 ms$0.02
40 h agoPassed402415 ms$0.02
44 h agoPassed402334 ms$0.02
2 days agoPassed402362 ms$0.02
2 days agoPassed402337 ms$0.02
2 days agoPassed402365 ms$0.02