Liquidation history
curl --request POST \
--url 'https://api.hypedexer.com/info#liqHistory' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "liqHistory",
"coin": "BTC",
"amountDollars": 10000,
"limit": 1
}
'import requests
url = "https://api.hypedexer.com/info#liqHistory"
payload = {
"type": "liqHistory",
"coin": "BTC",
"amountDollars": 10000,
"limit": 1
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({type: 'liqHistory', coin: 'BTC', amountDollars: 10000, limit: 1})
};
fetch('https://api.hypedexer.com/info#liqHistory', 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.hypedexer.com/info#liqHistory",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'type' => 'liqHistory',
'coin' => 'BTC',
'amountDollars' => 10000,
'limit' => 1
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.hypedexer.com/info#liqHistory"
payload := strings.NewReader("{\n \"type\": \"liqHistory\",\n \"coin\": \"BTC\",\n \"amountDollars\": 10000,\n \"limit\": 1\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.hypedexer.com/info#liqHistory")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"type\": \"liqHistory\",\n \"coin\": \"BTC\",\n \"amountDollars\": 10000,\n \"limit\": 1\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hypedexer.com/info#liqHistory")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"type\": \"liqHistory\",\n \"coin\": \"BTC\",\n \"amountDollars\": 10000,\n \"limit\": 1\n}"
response = http.request(request)
puts response.read_body[
{
"time": "2026-10-31T01:01:48",
"time_ms": 1793408508317,
"coin": "BTC",
"hash": "0x1e27...7aff",
"liquidated_user": "0xa031...c953",
"size_total": 0.33694,
"notional_total": 26147.55482,
"fill_px_vwap": 77603,
"mark_px": 77599.2,
"method": "market",
"fee_total_liquidated": 11.766399,
"liquidators": [
"0xbc04...dc3a"
],
"liquidator_count": 1,
"liq_dir": "Short",
"tid": 640095043539065
}
]{
"error": "Invalid API key"
}Liquidations
Liquidation history
Liquidation events of every user, or of one user, from our index: liquidated user, size, notional, VWAP fill price, mark price, method and liquidators. Same data as the liquidation endpoints of the Indexed Data REST API.
amountDollarskeeps events with at least that notional (USD).orderisDESC(newest first, default) orASC.- Paging: pass the
X-Next-Cursorresponse header ascursorwhileX-Has-Moreistrue.X-Total-Countgives the number of matching events.
Coverage: from 2025-03-22; the newest events are typically a minute old. On the oldest rows, some fields (such as liquidators) can be empty.
POST
/
info#liqHistory
Liquidation history
curl --request POST \
--url 'https://api.hypedexer.com/info#liqHistory' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "liqHistory",
"coin": "BTC",
"amountDollars": 10000,
"limit": 1
}
'import requests
url = "https://api.hypedexer.com/info#liqHistory"
payload = {
"type": "liqHistory",
"coin": "BTC",
"amountDollars": 10000,
"limit": 1
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({type: 'liqHistory', coin: 'BTC', amountDollars: 10000, limit: 1})
};
fetch('https://api.hypedexer.com/info#liqHistory', 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.hypedexer.com/info#liqHistory",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'type' => 'liqHistory',
'coin' => 'BTC',
'amountDollars' => 10000,
'limit' => 1
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.hypedexer.com/info#liqHistory"
payload := strings.NewReader("{\n \"type\": \"liqHistory\",\n \"coin\": \"BTC\",\n \"amountDollars\": 10000,\n \"limit\": 1\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.hypedexer.com/info#liqHistory")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"type\": \"liqHistory\",\n \"coin\": \"BTC\",\n \"amountDollars\": 10000,\n \"limit\": 1\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hypedexer.com/info#liqHistory")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"type\": \"liqHistory\",\n \"coin\": \"BTC\",\n \"amountDollars\": 10000,\n \"limit\": 1\n}"
response = http.request(request)
puts response.read_body[
{
"time": "2026-10-31T01:01:48",
"time_ms": 1793408508317,
"coin": "BTC",
"hash": "0x1e27...7aff",
"liquidated_user": "0xa031...c953",
"size_total": 0.33694,
"notional_total": 26147.55482,
"fill_px_vwap": 77603,
"mark_px": 77599.2,
"method": "market",
"fee_total_liquidated": 11.766399,
"liquidators": [
"0xbc04...dc3a"
],
"liquidator_count": 1,
"liq_dir": "Short",
"tid": 640095043539065
}
]{
"error": "Invalid API key"
}Authorizations
Your Hypedexer API key, sent as Authorization: Bearer <key>. The X-API-Key: <key> header and the api_key query parameter are accepted as well.
Body
application/json
Available options:
liqHistory Coin filter
Liquidated user filter
Epoch ms
Epoch ms
Minimum notional (USD)
Required range:
x >= 0Required range:
1 <= x <= 5000X-Next-Cursor of the previous page
Available options:
ASC, DESC Response
Liquidation events
ISO 8601, UTC
e.g. market
Long or Short