Get Lighter liquidation events

curl --request GET \
  --url https://api.0xarchive.io/v1/lighter/liquidations/{symbol} \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.0xarchive.io/v1/lighter/liquidations/{symbol}', 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}"

	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",
      "timestamp": 1785116108743,
      "transaction_time_us": 1785116108751813,
      "trade_id": 26144238102,
      "liquidation_type": "liquidation",
      "price": 64921.9,
      "size": 0.18476,
      "usd_amount": 11994.970244,
      "ask_account": "728637",
      "bid_account": "726722",
      "ask_order_id": 562952982931319,
      "bid_order_id": 844421854021817,
      "is_maker_ask": false,
      "taker_position_size_before": 0.19771,
      "maker_position_size_before": -1.85452,
      "taker_entry_quote_before": 12945.451185,
      "maker_entry_quote_before": 120665.315247,
      "taker_initial_margin_fraction_before": 200,
      "maker_initial_margin_fraction_before": 500,
      "taker_allocated_margin_usdc_before": 259232053,
      "taker_allocated_margin_usdc_after": 23859483,
      "maker_allocated_margin_usdc_before": 0,
      "maker_allocated_margin_usdc_after": 0,
      "taker_fee": 10000,
      "maker_fee": 28,
      "taker_position_sign_changed": false,
      "maker_position_sign_changed": false,
      "block_height": 300340672,
      "tx_hash": "000000198190c10e0000019fa13627c7000000000000000000000000000000000000000000000000",
      "raw_json": "<string>",
      "source": "ws",
      "timestamp_ms": 1767225600000
    }
  ],
  "meta": {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "count": 123,
    "has_more": true,
    "next_cursor": "<string>",
    "symbol": "BTC",
    "venue": "hyperliquid",
    "coverage_from": "2023-11-07T05:31:56Z",
    "notice": "<string>",
    "finalized_through": "2023-11-07T05:31:56Z",
    "requested_end": "2023-11-07T05:31:56Z",
    "clamped_to": "2023-11-07T05:31:56Z",
    "preliminary_row_count": 123
  }
}

GET

https://api.0xarchive.io

lighter

liquidations

{symbol}

Get Lighter liquidation events

curl --request GET \
  --url https://api.0xarchive.io/v1/lighter/liquidations/{symbol} \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.0xarchive.io/v1/lighter/liquidations/{symbol}', 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}"

	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",
      "timestamp": 1785116108743,
      "transaction_time_us": 1785116108751813,
      "trade_id": 26144238102,
      "liquidation_type": "liquidation",
      "price": 64921.9,
      "size": 0.18476,
      "usd_amount": 11994.970244,
      "ask_account": "728637",
      "bid_account": "726722",
      "ask_order_id": 562952982931319,
      "bid_order_id": 844421854021817,
      "is_maker_ask": false,
      "taker_position_size_before": 0.19771,
      "maker_position_size_before": -1.85452,
      "taker_entry_quote_before": 12945.451185,
      "maker_entry_quote_before": 120665.315247,
      "taker_initial_margin_fraction_before": 200,
      "maker_initial_margin_fraction_before": 500,
      "taker_allocated_margin_usdc_before": 259232053,
      "taker_allocated_margin_usdc_after": 23859483,
      "maker_allocated_margin_usdc_before": 0,
      "maker_allocated_margin_usdc_after": 0,
      "taker_fee": 10000,
      "maker_fee": 28,
      "taker_position_sign_changed": false,
      "maker_position_sign_changed": false,
      "block_height": 300340672,
      "tx_hash": "000000198190c10e0000019fa13627c7000000000000000000000000000000000000000000000000",
      "raw_json": "<string>",
      "source": "ws",
      "timestamp_ms": 1767225600000
    }
  ],
  "meta": {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "count": 123,
    "has_more": true,
    "next_cursor": "<string>",
    "symbol": "BTC",
    "venue": "hyperliquid",
    "coverage_from": "2023-11-07T05:31:56Z",
    "notice": "<string>",
    "finalized_through": "2023-11-07T05:31:56Z",
    "requested_end": "2023-11-07T05:31:56Z",
    "clamped_to": "2023-11-07T05:31:56Z",
    "preliminary_row_count": 123
  }
}

API key required. Send X-API-Key with this request. See REST authentication.

Operation schema

Shared request rules

Machine schema

Open the generated operation schema for machine-readable request and response details.

Authorizations

X-API-Key

string

header

required

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

Headers

0xArchive-Version

enum<string>

Selects the 2026-10 response contract. Send 2026-10-01; any dated version on or after it selects the same shapes. Without the header every response keeps its existing shape. With it:

The data quality routes, /v1/status/coverage and /v1/symbols answer the standard {success, data, meta} envelope.
Record times that are integer milliseconds by default become RFC 3339 UTC strings with millisecond precision, and the integer moves to a *_ms field: L4 resting-order timestamp (timestamp_ms), CVD buckets, HIP-3 oracle reads, Lighter and Lighter on Robinhood Chain liquidations and liquidation volume. Levels and trigger-levels snapshot_ts become RFC 3339 with snapshot_ts_ms.
Error bodies carry the contract error_code names: invalid_parameter instead of invalid_query_params and invalid_path_params, historical_depth_exceeded instead of history_window_exceeded, and historical_range_exceeded instead of request_range_exceeded; a malformed cursor that fails to parse answers 400 invalid_cursor instead of invalid_query_params. With 0xArchive-Version: 2026-10-01, malformed cursors on trades, liquidations, L2 and L4 diffs, order history, TP/SL and order-flow routes answer 400 invalid_cursor. Without the header, the first six route families treat a malformed cursor as no cursor and return the first page; order flow answers 400 invalid_query_params. Malformed trade time inputs answer 400 invalid_time_range with the header and 400 invalid_query_params without it.

The response echoes the selected version in its own 0xArchive-Version header.

Available options:

2026-10-01

Example:

"2026-10-01"

Path Parameters

symbol

string

required

Lighter market symbol.

Example:

"BTC"

Query Parameters

start

Start timestamp. Defaults depend on the route family. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z. An instant: Unix milliseconds, or an RFC 3339 string such as 2026-01-01T00:00:00Z (encode a + offset as %2B). An unparsable value answers 400 invalid_time_range.

Example:

1767225600000

end

End timestamp. Defaults to now. Accepts Unix milliseconds or an RFC 3339 UTC string such as 2026-01-01T00:00:00Z. An instant: Unix milliseconds, or an RFC 3339 string such as 2026-01-01T00:00:00Z (encode a + offset as %2B). An unparsable value answers 400 invalid_time_range.

Example:

1767225600000

cursor

string

Opaque pagination cursor: pass meta.next_cursor from the previous page unchanged, with the same filters. Omit it for the first page.

limit

integer

default:100

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

Required range: x <= 1000

Response

Lighter liquidation events

API response containing an array of native Lighter liquidation events

success

boolean

Example:

true

data

object[]

Hide child attributes

data.symbol

string

required

Trading pair symbol

Example:

"BTC"

data.timestamp

required

Liquidation time. By default an integer, Unix milliseconds. With 0xArchive-Version: 2026-10-01 an RFC 3339 UTC string with millisecond precision, and the integer moves to timestamp_ms.

Example:

1785116108743

data.transaction_time_us

integer<int64>

required

Intra-block transaction time in microseconds

Example:

1785116108751813

data.trade_id

integer<int64>

required

Unique Lighter trade ID of the liquidation fill

Example:

26144238102

data.liquidation_type

string

required

Upstream liquidation type

Example:

"liquidation"

data.price

number

required

Execution price

Example:

64921.9

data.size

number

required

Liquidated size in base units

Example:

0.18476

data.usd_amount

number

required

Notional value of the liquidation in USD

Example:

11994.970244

data.ask_account

string

required

Lighter account index on the ask side (serialized as a string)

Example:

"728637"

data.bid_account

string

required

Lighter account index on the bid side (serialized as a string)

Example:

"726722"

data.ask_order_id

integer<int64>

required

Order ID on the ask side

Example:

562952982931319

data.bid_order_id

integer<int64>

required

Order ID on the bid side

Example:

844421854021817

data.is_maker_ask

boolean

required

True if the maker was on the ask side

Example:

false

data.taker_position_size_before

number

required

Taker's signed position size before the fill (long positive, short negative)

Example:

0.19771

data.maker_position_size_before

number

required

Maker's signed position size before the fill

Example:

-1.85452

data.taker_entry_quote_before

number

required

Taker's position entry quote value before the fill

Example:

12945.451185

data.maker_entry_quote_before

number

required

Maker's position entry quote value before the fill

Example:

120665.315247

data.taker_initial_margin_fraction_before

integer

required

Taker's initial margin fraction before the fill (raw upstream units)

Example:

200

data.maker_initial_margin_fraction_before

integer

required

Maker's initial margin fraction before the fill (raw upstream units)

Example:

500

data.taker_allocated_margin_usdc_before

integer<int64>

required

Taker's isolated-margin USDC allocation before the fill (raw upstream units)

Example:

259232053

data.taker_allocated_margin_usdc_after

integer<int64>

required

Taker's isolated-margin USDC allocation after the fill (raw upstream units)

Example:

23859483

data.maker_allocated_margin_usdc_before

integer<int64>

required

Maker's isolated-margin USDC allocation before the fill (raw upstream units)

Example:

0

data.maker_allocated_margin_usdc_after

integer<int64>

required

Maker's isolated-margin USDC allocation after the fill (raw upstream units)

Example:

0

data.taker_fee

integer

required

Taker fee (raw upstream units)

Example:

10000

data.maker_fee

integer

required

Maker fee (raw upstream units)

Example:

28

data.taker_position_sign_changed

boolean

required

True if the fill flipped the taker's position between long and short

Example:

false

data.maker_position_sign_changed

boolean

required

True if the fill flipped the maker's position between long and short

Example:

false

data.block_height

integer<int64>

required

Lighter L2 block height containing the liquidation

Example:

300340672

data.tx_hash

string

required

Lighter settlement transaction hash (fixed-width hex)

Example:

"000000198190c10e0000019fa13627c7000000000000000000000000000000000000000000000000"

data.raw_json

string

required

Raw upstream payload as received from Lighter. Empty for rows backfilled from the venue's finalized export (source: "bucket", Lighter on Robinhood Chain).

data.source

string

required

Row provenance: ws for live capture; bucket for rows backfilled from the venue's finalized export (Lighter on Robinhood Chain), which carry an empty raw_json.

Example:

"ws"

data.timestamp_ms

integer<int64>

With 0xArchive-Version: 2026-10-01 only: timestamp as Unix milliseconds.

Example:

1767225600000

Endpoint reference

Requests and responses

Datasets

Venues

OpenAPI and schemas

Guides

Get Lighter liquidation events

Authorizations

Headers

Path Parameters

Query Parameters

Response