Liquidations Aggregate (Futures and Perpetuals)
curl --request GET \
--url https://api.amberdata.com/markets/derivatives/analytics/futures-perpetuals/liquidations-total \
--header 'x-api-key: <api-key>'import requests
url = "https://api.amberdata.com/markets/derivatives/analytics/futures-perpetuals/liquidations-total"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.amberdata.com/markets/derivatives/analytics/futures-perpetuals/liquidations-total', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.amberdata.com/markets/derivatives/analytics/futures-perpetuals/liquidations-total",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.amberdata.com/markets/derivatives/analytics/futures-perpetuals/liquidations-total"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.amberdata.com/markets/derivatives/analytics/futures-perpetuals/liquidations-total")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.amberdata.com/markets/derivatives/analytics/futures-perpetuals/liquidations-total")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"status": 200,
"title": "OK",
"description": "Successful request",
"payload": {
"data": [
{
"timestamp": "2024-11-05 00:00:00 000",
"exchange": "binance",
"buyLiquidationsUSD": 407,
"sellLiquidationsUSD": 0,
"averagePrice": 67776.44798099755
},
{
"timestamp": "2024-11-05 00:00:00 000",
"exchange": "bitmex",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67776.44798099755
},
{
"timestamp": "2024-11-05 00:00:00 000",
"exchange": "bybit",
"buyLiquidationsUSD": 407,
"sellLiquidationsUSD": 0,
"averagePrice": 67776.44798099755
},
{
"timestamp": "2024-11-05 00:00:00 000",
"exchange": "deribit",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67776.44798099755
},
{
"timestamp": "2024-11-05 00:00:00 000",
"exchange": "huobi",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67776.44798099755
},
{
"timestamp": "2024-11-05 00:00:00 000",
"exchange": "okex",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67776.44798099755
},
{
"timestamp": "2024-11-04 23:45:00 000",
"exchange": "binance",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 21654,
"averagePrice": 67618.94900542521
},
{
"timestamp": "2024-11-04 23:45:00 000",
"exchange": "bitmex",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67618.94900542521
},
{
"timestamp": "2024-11-04 23:45:00 000",
"exchange": "bybit",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 51032,
"averagePrice": 67618.94900542521
},
{
"timestamp": "2024-11-04 23:45:00 000",
"exchange": "deribit",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67618.94900542521
},
{
"timestamp": "2024-11-04 23:45:00 000",
"exchange": "huobi",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 271,
"averagePrice": 67618.94900542521
},
{
"timestamp": "2024-11-04 23:45:00 000",
"exchange": "okex",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 203,
"averagePrice": 67618.94900542521
},
{
"timestamp": "2024-11-04 23:30:00 000",
"exchange": "binance",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67779.18988764042
},
{
"timestamp": "2024-11-04 23:30:00 000",
"exchange": "bitmex",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67779.18988764042
},
{
"timestamp": "2024-11-04 23:30:00 000",
"exchange": "bybit",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67779.18988764042
},
{
"timestamp": "2024-11-04 23:30:00 000",
"exchange": "deribit",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67779.18988764042
},
{
"timestamp": "2024-11-04 23:30:00 000",
"exchange": "huobi",
"buyLiquidationsUSD": 1970,
"sellLiquidationsUSD": 0,
"averagePrice": 67779.18988764042
},
{
"timestamp": "2024-11-04 23:30:00 000",
"exchange": "okex",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67779.18988764042
},
{
"timestamp": "2024-11-04 23:15:00 000",
"exchange": "binance",
"buyLiquidationsUSD": 4954,
"sellLiquidationsUSD": 2642,
"averagePrice": 67691.32767402376
},
{
"timestamp": "2024-11-04 23:15:00 000",
"exchange": "bitmex",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67691.32767402376
},
{
"timestamp": "2024-11-04 23:15:00 000",
"exchange": "bybit",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 105157,
"averagePrice": 67691.32767402376
},
{
"timestamp": "2024-11-04 23:15:00 000",
"exchange": "deribit",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67691.32767402376
},
{
"timestamp": "2024-11-04 23:15:00 000",
"exchange": "huobi",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 7231,
"averagePrice": 67691.32767402376
},
{
"timestamp": "2024-11-04 23:15:00 000",
"exchange": "okex",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 4066,
"averagePrice": 67691.32767402376
},
{
"timestamp": "2024-11-04 23:00:00 000",
"exchange": "binance",
"buyLiquidationsUSD": 16892,
"sellLiquidationsUSD": 25162,
"averagePrice": 67779.24759519029
},
{
"timestamp": "2024-11-04 23:00:00 000",
"exchange": "bitmex",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67779.24759519029
},
{
"timestamp": "2024-11-04 23:00:00 000",
"exchange": "bybit",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 204,
"averagePrice": 67779.24759519029
},
{
"timestamp": "2024-11-04 23:00:00 000",
"exchange": "deribit",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67779.24759519029
},
{
"timestamp": "2024-11-04 23:00:00 000",
"exchange": "huobi",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 3326,
"averagePrice": 67779.24759519029
},
{
"timestamp": "2024-11-04 23:00:00 000",
"exchange": "okex",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67779.24759519029
},
{
"timestamp": "2024-11-04 22:45:00 000",
"exchange": "binance",
"buyLiquidationsUSD": 307664,
"sellLiquidationsUSD": 0,
"averagePrice": 67746.61886792466
},
{
"timestamp": "2024-11-04 22:45:00 000",
"exchange": "bitmex",
"buyLiquidationsUSD": 2021,
"sellLiquidationsUSD": 0,
"averagePrice": 67746.61886792466
},
{
"timestamp": "2024-11-04 22:45:00 000",
"exchange": "bybit",
"buyLiquidationsUSD": 94311,
"sellLiquidationsUSD": 0,
"averagePrice": 67746.61886792466
},
{
"timestamp": "2024-11-04 22:45:00 000",
"exchange": "deribit",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67746.61886792466
},
{
"timestamp": "2024-11-04 22:45:00 000",
"exchange": "huobi",
"buyLiquidationsUSD": 555200,
"sellLiquidationsUSD": 0,
"averagePrice": 67746.61886792466
},
{
"timestamp": "2024-11-04 22:45:00 000",
"exchange": "okex",
"buyLiquidationsUSD": 507007,
"sellLiquidationsUSD": 0,
"averagePrice": 67746.61886792466
}
]
}
}{}Futures/Perpetuals
Liquidations Aggregate (Futures and Perpetuals)
This endpoint returns the total aggregated liquidations for both futures and perpetuals for a selected time interval and exchange venue. The liquidations are split into “Buy-To-Close” and “Sell-To-Close” buckets. The endpoint is dynamic in terms of granularity. 1-day of data returns 5-min, 7-days returns hourly, 30-days returns daily.
GET
/
analytics
/
futures-perpetuals
/
liquidations-total
Liquidations Aggregate (Futures and Perpetuals)
curl --request GET \
--url https://api.amberdata.com/markets/derivatives/analytics/futures-perpetuals/liquidations-total \
--header 'x-api-key: <api-key>'import requests
url = "https://api.amberdata.com/markets/derivatives/analytics/futures-perpetuals/liquidations-total"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.amberdata.com/markets/derivatives/analytics/futures-perpetuals/liquidations-total', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.amberdata.com/markets/derivatives/analytics/futures-perpetuals/liquidations-total",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.amberdata.com/markets/derivatives/analytics/futures-perpetuals/liquidations-total"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.amberdata.com/markets/derivatives/analytics/futures-perpetuals/liquidations-total")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.amberdata.com/markets/derivatives/analytics/futures-perpetuals/liquidations-total")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"status": 200,
"title": "OK",
"description": "Successful request",
"payload": {
"data": [
{
"timestamp": "2024-11-05 00:00:00 000",
"exchange": "binance",
"buyLiquidationsUSD": 407,
"sellLiquidationsUSD": 0,
"averagePrice": 67776.44798099755
},
{
"timestamp": "2024-11-05 00:00:00 000",
"exchange": "bitmex",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67776.44798099755
},
{
"timestamp": "2024-11-05 00:00:00 000",
"exchange": "bybit",
"buyLiquidationsUSD": 407,
"sellLiquidationsUSD": 0,
"averagePrice": 67776.44798099755
},
{
"timestamp": "2024-11-05 00:00:00 000",
"exchange": "deribit",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67776.44798099755
},
{
"timestamp": "2024-11-05 00:00:00 000",
"exchange": "huobi",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67776.44798099755
},
{
"timestamp": "2024-11-05 00:00:00 000",
"exchange": "okex",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67776.44798099755
},
{
"timestamp": "2024-11-04 23:45:00 000",
"exchange": "binance",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 21654,
"averagePrice": 67618.94900542521
},
{
"timestamp": "2024-11-04 23:45:00 000",
"exchange": "bitmex",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67618.94900542521
},
{
"timestamp": "2024-11-04 23:45:00 000",
"exchange": "bybit",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 51032,
"averagePrice": 67618.94900542521
},
{
"timestamp": "2024-11-04 23:45:00 000",
"exchange": "deribit",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67618.94900542521
},
{
"timestamp": "2024-11-04 23:45:00 000",
"exchange": "huobi",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 271,
"averagePrice": 67618.94900542521
},
{
"timestamp": "2024-11-04 23:45:00 000",
"exchange": "okex",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 203,
"averagePrice": 67618.94900542521
},
{
"timestamp": "2024-11-04 23:30:00 000",
"exchange": "binance",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67779.18988764042
},
{
"timestamp": "2024-11-04 23:30:00 000",
"exchange": "bitmex",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67779.18988764042
},
{
"timestamp": "2024-11-04 23:30:00 000",
"exchange": "bybit",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67779.18988764042
},
{
"timestamp": "2024-11-04 23:30:00 000",
"exchange": "deribit",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67779.18988764042
},
{
"timestamp": "2024-11-04 23:30:00 000",
"exchange": "huobi",
"buyLiquidationsUSD": 1970,
"sellLiquidationsUSD": 0,
"averagePrice": 67779.18988764042
},
{
"timestamp": "2024-11-04 23:30:00 000",
"exchange": "okex",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67779.18988764042
},
{
"timestamp": "2024-11-04 23:15:00 000",
"exchange": "binance",
"buyLiquidationsUSD": 4954,
"sellLiquidationsUSD": 2642,
"averagePrice": 67691.32767402376
},
{
"timestamp": "2024-11-04 23:15:00 000",
"exchange": "bitmex",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67691.32767402376
},
{
"timestamp": "2024-11-04 23:15:00 000",
"exchange": "bybit",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 105157,
"averagePrice": 67691.32767402376
},
{
"timestamp": "2024-11-04 23:15:00 000",
"exchange": "deribit",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67691.32767402376
},
{
"timestamp": "2024-11-04 23:15:00 000",
"exchange": "huobi",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 7231,
"averagePrice": 67691.32767402376
},
{
"timestamp": "2024-11-04 23:15:00 000",
"exchange": "okex",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 4066,
"averagePrice": 67691.32767402376
},
{
"timestamp": "2024-11-04 23:00:00 000",
"exchange": "binance",
"buyLiquidationsUSD": 16892,
"sellLiquidationsUSD": 25162,
"averagePrice": 67779.24759519029
},
{
"timestamp": "2024-11-04 23:00:00 000",
"exchange": "bitmex",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67779.24759519029
},
{
"timestamp": "2024-11-04 23:00:00 000",
"exchange": "bybit",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 204,
"averagePrice": 67779.24759519029
},
{
"timestamp": "2024-11-04 23:00:00 000",
"exchange": "deribit",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67779.24759519029
},
{
"timestamp": "2024-11-04 23:00:00 000",
"exchange": "huobi",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 3326,
"averagePrice": 67779.24759519029
},
{
"timestamp": "2024-11-04 23:00:00 000",
"exchange": "okex",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67779.24759519029
},
{
"timestamp": "2024-11-04 22:45:00 000",
"exchange": "binance",
"buyLiquidationsUSD": 307664,
"sellLiquidationsUSD": 0,
"averagePrice": 67746.61886792466
},
{
"timestamp": "2024-11-04 22:45:00 000",
"exchange": "bitmex",
"buyLiquidationsUSD": 2021,
"sellLiquidationsUSD": 0,
"averagePrice": 67746.61886792466
},
{
"timestamp": "2024-11-04 22:45:00 000",
"exchange": "bybit",
"buyLiquidationsUSD": 94311,
"sellLiquidationsUSD": 0,
"averagePrice": 67746.61886792466
},
{
"timestamp": "2024-11-04 22:45:00 000",
"exchange": "deribit",
"buyLiquidationsUSD": 0,
"sellLiquidationsUSD": 0,
"averagePrice": 67746.61886792466
},
{
"timestamp": "2024-11-04 22:45:00 000",
"exchange": "huobi",
"buyLiquidationsUSD": 555200,
"sellLiquidationsUSD": 0,
"averagePrice": 67746.61886792466
},
{
"timestamp": "2024-11-04 22:45:00 000",
"exchange": "okex",
"buyLiquidationsUSD": 507007,
"sellLiquidationsUSD": 0,
"averagePrice": 67746.61886792466
}
]
}
}{}Authorizations
Query Parameters
[Required] The underlying currency for which there are futures contracts/instruments.
[Examples] BTC | ETH
[Required] Payload only includes data after this date (inclusive).
[Formats] seconds | milliseconds | iso8601
[Examples] 1578531600 | 1578531600000 | 2020-09-01T01:00:00
[Required] Payload only includes data before this date (exclusive).
[Formats] seconds | milliseconds | iso8601
[Examples] 1578531600 | 1578531600000 | 2020-09-01T01:00:00
[Optional] Time format of the timestamps in the return payload.
[Defaults] milliseconds | ms* | iso | iso8601 | hr | human_readable
Was this page helpful?
⌘I