Lighter - Positions

Resolve Lighter accounts by L1 address

List the Lighter mainnet account indices owned by an L1 address, with total_accounts. Lighter position routes take account indices. Not available on Lighter on Robinhood Chain. Billed at 1 credit per request.

get/v1/lighter/accounts

Request

  • Base URL: https://api.0xarchive.io
  • URL: https://api.0xarchive.io/v1/lighter/accounts
  • Auth: API key in header X-API-Key

Query parameters

l1_addressstring required

L1 address: 0x followed by 40 hex characters.

limitinteger

Maximum rows per page (default 500, max 5000).

cursorstring

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

Response

Resolve Lighter accounts by L1 address

successboolean required

Example response

{
  "success": true,
  "data": {
    "l1_address": "0x31ca8395cf837de08b24da3f660e77761dfb974b",
    "total_accounts": 3,
    "accounts": [
      {
        "account_index": "513030"
      }
    ]
  },
  "meta": {
    "totals": {
      "symbol": "BTC",
      "coin": "BTC",
      "dex": "xyz",
      "long_count": 18234,
      "short_count": 15102,
      "long_size": "8123.45",
      "short_size": "8120.1",
      "long_value": "528000000.5",
      "short_value": "527800000.25",
      "long_avg_entry_price": "63120.4",
      "short_avg_entry_price": "66210.9",
      "long_positions_with_entry": 18230,
      "short_positions_with_entry": 15100,
      "long_top10_value_share": "0.412345",
      "short_top10_value_share": "0.385",
      "top10_value_share": "0.301",
      "quality": "complete"
    },
    "symbol": "BTC",
    "venue": "hyperliquid"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.