Get Lighter on Robinhood Chain liquidation events

curl --request GET \
  --url https://api.0xarchive.io/v1/rh-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/rh-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/rh-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"
    }
  ],
  "meta": {
    "count": 123,
    "next_cursor": "<string>",
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}

{
  "code": 400,
  "error": "Failed to deserialize query string: limit: invalid digit found in string",
  "error_code": "invalid_query_params",
  "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05"
}

{
  "code": 401,
  "error": "Missing or invalid API key. Provide X-API-Key header."
}

{
  "code": 429,
  "error": "Rate limit exceeded"
}

GET

https://api.0xarchive.io

rh-lighter

liquidations

{symbol}

Get Lighter on Robinhood Chain liquidation events

curl --request GET \
  --url https://api.0xarchive.io/v1/rh-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/rh-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/rh-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"
    }
  ],
  "meta": {
    "count": 123,
    "next_cursor": "<string>",
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}

{
  "code": 400,
  "error": "Failed to deserialize query string: limit: invalid digit found in string",
  "error_code": "invalid_query_params",
  "request_id": "3f2a9c71-5b0e-4d68-9a4c-7e1d2b6f8a05"
}

{
  "code": 401,
  "error": "Missing or invalid API key. Provide X-API-Key header."
}

{
  "code": 429,
  "error": "Rate limit exceeded"
}

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

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

Path Parameters

symbol

string

required

Perpetual market symbol on Lighter on Robinhood Chain (uppercase, e.g. BTC). Spot pairs have no open interest, funding, or liquidations.

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

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

integer<int64>

required

Liquidation timestamp in Unix epoch milliseconds

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"

API reference

SDKs & tooling

AI & agents

Get Lighter on Robinhood Chain liquidation events

Authorizations

Path Parameters

Query Parameters

Response