Get recent Lighter on Robinhood Chain trades

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

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

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

	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": [
    {
      "coin": "BTC",
      "symbol": "BTC",
      "side": "B",
      "price": "64708.5",
      "size": "0.00005",
      "timestamp": "2026-07-26T14:47:59.174Z",
      "trade_id": 26121110211,
      "crossed": false,
      "source": "bucket",
      "tx_hash": "000000197b6fd6e90000019f9ee5a9c6000000000000000000000000000000000000000000000000",
      "order_id": 844421856609148,
      "fee": "0.000028",
      "account_index": "513030",
      "position_size_before": -0.94632,
      "position_size_after": -0.94627,
      "entry_quote_before": 61179.114686,
      "initial_margin_fraction_before": 0.02,
      "allocated_margin_before": 0,
      "allocated_margin_after": 0,
      "position_sign_changed": false,
      "trade_type": "trade",
      "is_maker": true,
      "counterparty_address": "710765",
      "client_id": 46758119273906,
      "realized_pnl": -0.00295,
      "integrator_fee": 0,
      "fee_account_id": 0,
      "l2_block_height": 300075269,
      "transaction_time_us": 1785077279174437,
      "usdc_amount": 3.235425
    }
  ],
  "meta": {
    "count": 123,
    "next_cursor": "<string>",
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "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
  }
}

{
  "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

trades

{symbol}

recent

Get recent Lighter on Robinhood Chain trades

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

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

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

	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": [
    {
      "coin": "BTC",
      "symbol": "BTC",
      "side": "B",
      "price": "64708.5",
      "size": "0.00005",
      "timestamp": "2026-07-26T14:47:59.174Z",
      "trade_id": 26121110211,
      "crossed": false,
      "source": "bucket",
      "tx_hash": "000000197b6fd6e90000019f9ee5a9c6000000000000000000000000000000000000000000000000",
      "order_id": 844421856609148,
      "fee": "0.000028",
      "account_index": "513030",
      "position_size_before": -0.94632,
      "position_size_after": -0.94627,
      "entry_quote_before": 61179.114686,
      "initial_margin_fraction_before": 0.02,
      "allocated_margin_before": 0,
      "allocated_margin_after": 0,
      "position_sign_changed": false,
      "trade_type": "trade",
      "is_maker": true,
      "counterparty_address": "710765",
      "client_id": 46758119273906,
      "realized_pnl": -0.00295,
      "integrator_fee": 0,
      "fee_account_id": 0,
      "l2_block_height": 300075269,
      "transaction_time_us": 1785077279174437,
      "usdc_amount": 3.235425
    }
  ],
  "meta": {
    "count": 123,
    "next_cursor": "<string>",
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "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
  }
}

{
  "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

Market symbol on Lighter on Robinhood Chain. Perpetuals use the uppercase base symbol (BTC); spot pairs are dashed and USDG-quoted (AAPL-USDG). List markets with GET /v1/rh-lighter/instruments.

Example:

"BTC"

Query Parameters

limit

integer

default:100

Number of trades to return (default: 100, max: 1000)

Required range: x <= 1000

Response

List of recent trades

API response containing an array of Lighter trades. History responses serve canonical rows only and clamp end to finalized_through; /recent responses serve preliminary rows and report preliminary_row_count.

success

boolean

Example:

true

data

object[]

Hide child attributes

data.coin

string

required

deprecated

Trading pair symbol (deprecated, use symbol instead)

Example:

"BTC"

data.symbol

string

required

Trading pair symbol

Example:

"BTC"

data.side

enum<string>

required

Trade side of the account this row belongs to: 'B' (buy) or 'A' (sell/ask)

Available options:

A,

B

Example:

"B"

data.price

string

required

Execution price

Example:

"64708.5"

data.size

string

required

Trade size in base units

Example:

"0.00005"

data.timestamp

string<date-time>

required

Execution timestamp (UTC)

Example:

"2026-07-26T14:47:59.174Z"

data.trade_id

integer<int64>

required

Unique Lighter trade ID. Each trade produces two rows (one per counterparty) sharing this ID.

Example:

26121110211

data.crossed

boolean

required

True if this account was the taker (crossed the spread), false if maker

Example:

false

data.source

enum<string>

required

Row provenance: 'bucket' = canonical (finalized by the daily reconcile of the deployment's published trade history), 'ws' = preliminary real-time capture

Available options:

bucket,

ws

Example:

"bucket"

data.tx_hash

string | null

Lighter settlement transaction hash (fixed-width hex). Canonical rows only.

Example:

"000000197b6fd6e90000019f9ee5a9c6000000000000000000000000000000000000000000000000"

data.order_id

integer<int64> | null

Order ID of this account's order. Canonical rows only.

Example:

844421856609148

data.fee

string | null

This account's fee for the fill. Canonical rows only.

Example:

"0.000028"

data.account_index

string

Lighter numeric account index this row belongs to (serialized as a string)

Example:

"513030"

data.position_size_before

number | null

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

Example:

-0.94632

data.position_size_after

number | null

Signed position size after the fill (derived: position_size_before plus/minus size by side)

Example:

-0.94627

data.entry_quote_before

number | null

This account's position entry quote value before the fill

Example:

61179.114686

data.initial_margin_fraction_before

number | null

This account's initial margin fraction before the fill

Example:

0.02

data.allocated_margin_before

number | null

Isolated-margin allocation before the fill (0 for cross)

Example:

0

data.allocated_margin_after

number | null

Isolated-margin allocation after the fill (0 for cross)

Example:

0

data.position_sign_changed

boolean | null

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

Example:

false

data.trade_type

string | null

Upstream trade type. Canonical rows only.

Example:

"trade"

data.is_maker

boolean | null

True if this account was the maker. Canonical rows only.

Example:

true

data.counterparty_address

string | null

Counterparty's Lighter account index (serialized as a string). Canonical rows only.

Example:

"710765"

data.client_id

integer<int64> | null

Client-assigned order ID. Canonical rows only.

Example:

46758119273906

data.realized_pnl

number | null

Matching-engine realized PnL for this fill. Canonical rows only.

Example:

-0.00295

data.integrator_fee

number | null

Integrator fee charged on the fill. Canonical rows only.

Example:

0

data.fee_account_id

integer<int64> | null

Account credited with the fee. Canonical rows only.

Example:

0

data.l2_block_height

integer<int64> | null

Lighter L2 block height containing the trade. Canonical rows only.

Example:

300075269

data.transaction_time_us

integer<int64> | null

Intra-block transaction time in microseconds. Canonical rows only.

Example:

1785077279174437

data.usdc_amount

number | null

Notional value of the fill in USDC. Canonical rows only.

Example:

3.235425

API reference

SDKs & tooling

AI & agents

Get recent Lighter on Robinhood Chain trades

Authorizations

Path Parameters

Query Parameters

Response