Skip to main content
GET
https://api.0xarchive.io
/
v1
/
lighter
/
liquidations
/
{symbol}
/
volume
Get Lighter liquidation volume
curl --request GET \
  --url https://api.0xarchive.io/v1/lighter/liquidations/{symbol}/volume \
  --header 'X-API-Key: <api-key>'
import requests

url = "https://api.0xarchive.io/v1/lighter/liquidations/{symbol}/volume"

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.0xarchive.io/v1/lighter/liquidations/{symbol}/volume', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.0xarchive.io/v1/lighter/liquidations/{symbol}/volume"

	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))

}
{
  "success": true,
  "data": [
    {
      "symbol": "BTC",
      "coin": "BTC",
      "timestamp": "2025-05-21T10:00:00.000Z",
      "total_usd": 1250000.5,
      "long_usd": 750000.25,
      "short_usd": 500000.25,
      "count": 42,
      "long_count": 25,
      "short_count": 17
    }
  ],
  "meta": {
    "count": 123,
    "next_cursor": "<string>"
  }
}
{
  "code": 400,
  "error": "Invalid request parameters"
}
{
  "code": 401,
  "error": "Missing or invalid API key. Provide X-API-Key header."
}
{
  "code": 429,
  "error": "Rate limit exceeded"
}

Authorizations

X-API-Key
string
header
required

API key for authentication. Get yours at https://0xarchive.io/dashboard

Path Parameters

symbol
string
required

Lighter market symbol.

Example:

"BTC"

Query Parameters

start
integer<int64>

Start timestamp in Unix milliseconds. Defaults depend on the route family.

end
integer<int64>

End timestamp in Unix milliseconds. Defaults to now.

cursor
string

Cursor for pagination. Use the value from the previous response metadata.

limit
integer
default:100

Maximum number of results (default: 100, max: 1000)

Required range: x <= 1000
interval
enum<string>
default:1h

Aggregation interval. Defaults to 1h.

Available options:
5m,
15m,
30m,
1h,
4h,
1d

Response

Lighter liquidation volume buckets

API response containing an array of aggregated liquidation volumes

success
boolean
Example:

true

data
object[]
meta
object
Last modified on July 7, 2026