CoinGlass Liquidation Map API

What does CoinGlass Liquidation Map do?

CoinGlass Liquidation Map helps you search supported futures instruments and fetch liquidation map data for a selected instrument and range. Use search_symbols to find the correct symbol value, then send that value to liquidation_map to get clean JSON liquidation map output.

Why use CoinGlass Liquidation Map?

Use this Actor when you need structured liquidation map data for dashboards, market analysis, alerts, or automated workflows.

• Search futures instruments by keyword
• Fetch liquidation map data by instrument and range
• Use separate pay-per-event pricing for symbol searches and liquidation map data
• Export results as JSON, CSV, Excel, HTML, or RSS

How to use CoinGlass Liquidation Map

1. Open the Actor on Apify.
2. Select search_symbols to find an instrument, or liquidation_map to fetch map data.
3. Fill the matching input fields.
4. Click Start.
5. Read the output from the default dataset.

Input

Field	Required	Default	Description
mode	Yes	search_symbols	Operation to run. Supported values: search_symbols, liquidation_map.
keyword	No	empty	Optional search keyword used with search_symbols. Leave it empty to return the default futures symbol list.
symbol	Required for liquidation_map	Binance_BTCUSDT	Symbol value returned by search_symbols, such as Binance_BTCUSDT.
range	Required for liquidation_map	1d	Liquidation map range. Supported values: 1d, 7d, 30d, 90d, 180d, 365d.

Search symbols input example

{
    "mode": "search_symbols",
    "keyword": "btc"
}

keyword is optional. You can also leave it empty when using search_symbols.

Search symbols output example

{
    "success": true,
    "message": "Futures symbols fetched successfully.",
    "mode": "search_symbols",
    "keyword": "btc",
    "data": [
        {
            "base_asset": "BTC",
            "quote_asset": "USDT",
            "exchange": "Binance",
            "symbol": "Binance_BTCUSDT"
        }
    ]
}

Use the symbol value from the search_symbols response as the symbol input for liquidation_map.

Liquidation map input example

{
    "mode": "liquidation_map",
    "symbol": "Binance_BTCUSDT",
    "range": "1d"
}

Liquidation map output example

{
    "success": true,
    "message": "Liquidation map data fetched successfully.",
    "mode": "liquidation_map",
    "symbol": "Binance_BTCUSDT",
    "range": "1d",
    "data": {
        "48935": [ // Liquidation price
            [
                48935, // Liquidation price
                1579370.77, // Liquidation level
                25, // Leverage ratio
                null
            ]
        ]
    }
}

Data table

Field	Description
success	true when the Actor completed cleanly.
message	Human-readable result or warning message.
mode	Operation used for the run.
keyword	Search keyword, when search_symbols is used.
symbol	Search result symbol used for liquidation_map.
range	Liquidation map range, when liquidation_map is used.
data	Symbol search results or liquidation map data.
data.<price>	Liquidation price level key.
data.<price>[0][0]	Liquidation price.
data.<price>[0][1]	Liquidation level.
data.<price>[0][2]	Leverage ratio.

Pay-per-event pricing

This Actor uses separate charge events for each operation:

Event name	Used for
SEARCH_SYMBOLS	Searching futures instruments.
LIQUIDATION_MAP	Fetching liquidation map data.

Tips

• Run search_symbols first if you do not know the exact symbol.
• Use the returned symbol as the symbol input for liquidation_map.
• Use longer ranges such as 90d, 180d, or 365d for wider liquidation map snapshots.