Binance Large Liquidation Orders, Newest First (by Token Symbol)

omnial/binance-large-liquidation-orders

For one token symbol on Binance, returns individual liquidation orders worth at least a US-dollar threshold you set, newest first: each order's id, the exchange, the traded pair and its base asset, the liquidation price, the order's value in US dollars, whether a long or a short was closed, and the Unix time it happened. The response also says how many rows were asked for, whether more exist beyond them, and whether it came from the supplier's cache.

activeper callv1

Price

Up to $0.0164 per call; you pay what the call used

The price shown is the price you pay. No monthly minimum. Top-ups start at $5.

Data source

Binance

Liquidation data from Binance.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/binance-large-liquidation-orders" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/binance-large-liquidation-orders" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/binance-large-liquidation-orders", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/binance-large-liquidation-orders", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.0164

Updated: Oct 17, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "exchange",
    "symbol"
  ],
  "properties": {
    "limit": {
      "enum": [
        10,
        20
      ],
      "type": "integer",
      "default": 20,
      "description": "The most orders to return: 20 (the supplier's default) or 10."
    },
    "symbol": {
      "type": "string",
      "minLength": 1,
      "description": "The token's ticker symbol, as the exchange writes it for the perpetual's base asset."
    },
    "exchange": {
      "enum": [
        "Binance"
      ],
      "type": "string",
      "description": "The exchange whose liquidations are returned; only `Binance` is offered."
    },
    "min_amount": {
      "type": "string",
      "default": "10000",
      "minLength": 1,
      "description": "The smallest liquidation to return, as a plain number of US dollars. Defaults to the supplier's own `10000`; a lower figure returns smaller orders too."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "side": {
            "type": "string",
            "description": "Which side was closed: `long` or `short`."
          },
          "price": {
            "type": "number",
            "description": "The price the position was liquidated at, in the quote asset."
          },
          "symbol": {
            "type": "string",
            "description": "The traded pair, such as a base asset against a quote asset."
          },
          "exchange": {
            "type": "string",
            "description": "The exchange the order was closed on."
          },
          "order_id": {
            "type": "string",
            "description": "The exchange's identifier for the liquidation order."
          },
          "timestamp": {
            "type": "number",
            "description": "Unix seconds when the liquidation happened."
          },
          "usd_value": {
            "type": "number",
            "description": "The liquidated position's value in US dollars."
          },
          "base_asset": {
            "type": "string",
            "description": "The pair's base asset."
          }
        }
      },
      "description": "One entry per liquidation order, newest first."
    },
    "meta": {
      "type": "object",
      "properties": {
        "limit": {
          "type": "number",
          "description": "The row count the call asked for."
        },
        "cached": {
          "type": "boolean",
          "description": "Whether the rows were served from the supplier's cache."
        },
        "has_more": {
          "type": "boolean",
          "description": "Whether more orders match the request than the returned rows; this tool offers no way to fetch them."
        }
      },
      "description": "How many rows were asked for and how the answer was served."
    }
  },
  "description": "The matching liquidation orders."
}