Tollbridge Docs
API

Liquidations

Raw liquidation surfaces with honest unavailability — paid per the perp.liquidations endpoint.

GET /v1/liquidation/{asset} (paid)

Raw liquidation surfaces + honest unavailability. Paid per the perp.liquidations PRICING key.

curl -H "PAYMENT-SIGNATURE: <base64 payment payload>" \
  https://api.tollbridge.app/v1/liquidation/BTC

Response data — either

  • { asset, venue, window, available: true, surface: { window, total_usd, longs_usd, shorts_usd } }

or, when the venue lacks the feed,

  • { available: false, reason } — 200 with provenance, an honest unavailability, never a fabricated surface.

TypeScript

import { Tollbridge } from '@tollbridge/sdk-typescript';
import { account } from './wallet';

const paying = new Tollbridge({ baseUrl: 'https://api.tollbridge.app', x402: { signer: account } });

const surface = await paying.liquidation('BTC'); // raw surfaces, honest available:false
surface.data.available;

Python

import httpx

# Reference snippet — official Python SDK in progress.
r = httpx.get(
    "https://api.tollbridge.app/v1/liquidation/BTC",
    headers={"PAYMENT-SIGNATURE": payment_payload_b64},  # signed x402 payload
)
surface = r.json()["data"]
assert surface["available"] in (True, False)  # honesty is part of the contract

MCP

The raw surface is REST-only in v1. The engine decision computed over it (S02) is available as the tollbridge_liquidation_risk tool:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tollbridge_liquidation_risk",
    "arguments": { "asset": "BTC" }
  }
}

Market signals

Paid S01 regime decisions, and the S02 liquidation-risk route that honestly refuses — jevChoice distributions with honest refusals.

Funding

Raw funding snapshots and the paid S06/S07 decisions with explicit economics assumptions.

On this page

GET /v1/liquidation/{asset} (paid)TypeScriptPythonMCPRelated