CoinGlass Footprint History API

What does CoinGlass Footprint History do?

CoinGlass Footprint History helps you search supported futures instruments and fetch historical footprint chart data for a selected instrument, interval, and optional time range. Use search_symbols to find the correct symbol value, then send that value to footprint_history to get clean JSON output with buy and sell volume at each price level.

Why use CoinGlass Footprint History?

Use this Actor when you need futures footprint history data for dashboards, market analysis, order-flow research, alerts, or automated workflows.

• Search futures instruments by keyword
• Fetch footprint history by instrument, interval, and optional timestamps
• Get price-level buy and sell volume data
• Use separate pay-per-event pricing for symbol searches and footprint history data
• Export results as JSON, CSV, Excel, HTML, or RSS

How to use CoinGlass Footprint History

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

Input

Field	Required	Default	Description
mode	Yes	footprint_history	Operation to run. Supported values: search_symbols, footprint_history.
keyword	No	empty	Optional search keyword used with search_symbols. Leave it empty to return the default futures symbol list.
symbol	Required for footprint_history	Binance_BTCUSDT	Symbol value returned by search_symbols, such as Binance_BTCUSDT.
interval	Required for footprint_history	30m	Time interval for data aggregation. Supported values: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 1w.
startTime	No	empty	Optional start timestamp in seconds.
endTime	No	empty	Optional end timestamp in seconds.

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",
    "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 footprint_history.

Footprint history input example

{
    "mode": "footprint_history",
    "symbol": "Binance_BTCUSDT",
    "interval": "30m",
    "startTime": "1781244000",
    "endTime": "1781727922"
}

startTime and endTime are optional. If you leave them empty, the Actor fetches the default available footprint history for the selected symbol and interval.

Footprint history output example

The example below includes comments to explain each timestamp and price-level array value.

{
    "success": true,
    "message": "Footprint history data fetched successfully.",
    "mode": "footprint_history",
    "data": [
        [
            1757808000, // Timestamp (seconds)
            [
                [
                    115765,       // Price start
                    115770,       // Price end
                    3.223,        // Taker buy volume
                    9.906,        // Taker sell volume
                    373118.1958,  // Taker buy volume (quote currency)
                    1146773.5391, // Taker sell volume (quote currency)
                    373118.1958,  // Taker buy volume (USDT)
                    1146773.5391, // Taker sell volume (USDT)
                    193,          // Taker buy trade count
                    153           // Taker sell trade count
                ],
                [
                    115770,      // Price start
                    115775,      // Price end
                    3.315,       // Taker buy volume
                    0.528,       // Taker sell volume
                    383782.5569, // Taker buy volume (quote currency)
                    61127.0686,  // Taker sell volume (quote currency)
                    383782.5569, // Taker buy volume (USDT)
                    61127.0686,  // Taker sell volume (USDT)
                    40,          // Taker buy trade count
                    64           // Taker sell trade count
                ]
            ]
        ]
    ]
}

Data table

Field	Description
success	true when the Actor completed cleanly.
message	Human-readable result or warning message.
mode	Operation used for the run.
data	Footprint history data grouped by timestamp.
data[n][0]	Timestamp in seconds.
data[n][1]	Price-level footprint rows for that timestamp.
data[n][1][m][0]	Price level start.
data[n][1][m][1]	Price level end.
data[n][1][m][2]	Taker buy volume.
data[n][1][m][3]	Taker sell volume.
data[n][1][m][4]	Taker buy volume in quote currency.
data[n][1][m][5]	Taker sell volume in quote currency.
data[n][1][m][6]	Taker buy volume in USDT.
data[n][1][m][7]	Taker sell volume in USDT.
data[n][1][m][8]	Taker buy trade count.
data[n][1][m][9]	Taker sell trade count.

Pay-per-event pricing

This Actor uses separate charge events for each operation:

Event name	Used for
SEARCH_SYMBOLS	Searching futures instruments.
FOOTPRINT_HISTORY	Fetching footprint history data.

Tips

• Run search_symbols first if you do not know the exact symbol.
• Use the returned symbol as the symbol input for footprint_history.
• Leave startTime and endTime empty when you want the default available history.