--- title: "Get Lighter account summary" method: GET path: "/v1/lighter/accounts/{account_index}/account" tags: ["Lighter - Positions"] --- # Get Lighter account summary `GET /v1/lighter/accounts/{account_index}/account` ## Request - Base URL: `https://api.0xarchive.io` - URL: `https://api.0xarchive.io/v1/lighter/accounts/{account_index}/account` - Auth: API key in header `X-API-Key` Position aggregates of one account at the latest live snapshot: totals, long and short value, and the number of open positions. Lighter returns position aggregates only, not balances. Billed at 1 credit per request. ## Path parameters - `account_index` string, required ## Response `200` Get Lighter account summary - ApiResponseAccountSummaryArray: Account summaries (current: one per account or HIP-3 dex; history: one per hour). - `success` boolean, required - `data` AccountSummary[], required - `snapshot_ts` string, date-time: Hour the row describes. Present on hourly history rows only. - `account_index` string: Lighter only: account index as a string. - `dex` string: HIP-3 only: dex the account summary belongs to. - `account_value` string, nullable: Hyperliquid and HIP-3 only: account value in USD. - `cross_account_value` string, nullable: Hyperliquid and HIP-3 only: cross-margin account value in USD. - `collateral` string, nullable: Hyperliquid and HIP-3 only: collateral in USD. - `total_margin_used` string, nullable: Hyperliquid and HIP-3 only: total margin used in USD. - `cross_maintenance_margin_used` string, nullable: Hyperliquid and HIP-3 only: cross maintenance margin used in USD. - `withdrawable` string, nullable: Hyperliquid and HIP-3 only: withdrawable amount in USD. Null outside the periods where it was captured. - `total_position_value` string, nullable, required: Sum of absolute position values in USD. - `total_unrealized_pnl` string, nullable, required: Sum of unrealized PnL in USD. - `long_value` string, nullable, required: Value of long positions in USD. - `short_value` string, nullable, required: Value of short positions in USD. - `n_positions` integer, required: Number of open positions. - `account_mode` string: Hyperliquid and HIP-3 only: account abstraction mode, `standard`, `unified`, `portfolio`, `dex_abstraction`, or `unknown`. - `snapshot_as_of` string, date-time, nullable: Hyperliquid and HIP-3 only: time the clearinghouse fields describe. - `quality` string, required: `complete`, `partial` (a total is null because a position has no mark), or `degraded`. - `meta` PositionsMeta, required: Response metadata of the account positions routes. Every instant is RFC 3339 UTC with milliseconds and comes from the data, never the request time. - `count` integer, required: Number of records returned. - `next_cursor` string, nullable: Signed, opaque cursor for the next page, bound to the request; present exactly when `has_more` is `true`. Pass it back with the same parameters. A market cursor pins its snapshot; if that snapshot is replaced or expires the next page answers 409 `snapshot_advanced`. - `request_id` string, uuid, required: Unique request ID for support. - `as_of` string, date-time: Instant the returned state describes: the snapshot tick or hour, or the requested as-of time. - `snapshot_ts` string, date-time: Committed snapshot the response was read from. Market routes echo the resolved `hour` here. - `source` 'snapshot' | 'reconstructed' | 'changes': How the rows were produced: `snapshot` (live or hourly snapshot), `reconstructed` (as-of state between snapshots), or `changes` (change log). - `quality` string: Completeness of the snapshot the response was read from: `complete`, `partial`, or `degraded`. Rows carry their own `quality`. On Lighter and Robinhood Chain, snapshots from the latest day, before the venue's daily trade reconcile, can read `degraded` while their rows read `preliminary`; they read `complete` once the reconcile has run. - `stale` boolean: True on current reads when the latest snapshot is older than 12 minutes; paired with `notice`. - `built_through` string, date-time: Every event before this instant is built into the change log and as-of state. Reads are clamped to it. - `finalized_through` string, date-time: Every event before this instant is final and will not be re-derived (Lighter: the trade finalization watermark). Never later than `built_through`. - `requested_end` string, date-time: The `end` or `timestamp` the caller asked for, echoed when the read was clamped. - `clamped_to` string, date-time: Boundary the read was clamped to (`built_through`). Present only when clamped. - `totals` MarketPositionsSummary: Long and short aggregates of every open position in one market at one snapshot. Averages cover only positions with a known entry (`*_positions_with_entry`). Shares are decimal ratios of the side or total value held by the ten largest positions. - `snapshot_ts` string, date-time, nullable, required: Snapshot the aggregates describe. - `symbol` string, required - `coin` string, required: Alias of `symbol`. - `dex` string: HIP-3 only. - `long_count` integer, required - `short_count` integer, required - `long_size` string, required: Total long size in base units. - `short_size` string, required: Total short size in base units. - `long_value` string, nullable, required: Total long value in USD. Null when any long position has no mark. - `short_value` string, nullable, required: Total short value in USD. Null when any short position has no mark. - `long_avg_entry_price` string, nullable, required: Size-weighted average entry of long positions with a known entry. - `short_avg_entry_price` string, nullable, required: Size-weighted average entry of short positions with a known entry. - `long_positions_with_entry` integer, required - `short_positions_with_entry` integer, required - `long_top10_value_share` string, nullable, required: Share of long value held by the ten largest long positions. - `short_top10_value_share` string, nullable, required: Share of short value held by the ten largest short positions. - `top10_value_share` string, nullable, required: Share of total value held by the ten largest positions. - `quality` string, required: `complete`, `partial`, or `degraded`, from this market's own rows. - `coverage_from` string, date-time: Coverage start, present with `notice` when the request falls before coverage or the address has no recorded activity. - `notice` string: Human-readable advisory: before coverage, no recorded activity, or a stale snapshot. - `has_more` boolean: Cursor-paged routes: whether another page follows. `next_cursor` is present exactly when this is `true`. A final page can be empty when the previous page was exactly full; `has_more` is `false` on it. - `symbol` string: Per-symbol routes: the canonical public symbol the response describes (for example `BTC`, `xyz:TSLA`, `HYPE-USDC`, `#0`). - `venue` 'hyperliquid' | 'hip3' | 'hip4' | 'spot' | 'lighter' | 'rh-lighter': Per-symbol routes: the venue the response describes. ## Other responses - `400`: Invalid request: a parameter, symbol, interval, cursor or time range failed validation. See `error_code`. - `401`: Authentication required: the API key is missing or invalid. - `429`: Rate limit, concurrency limit or monthly credits exceeded. See `error_code`. - `503`: Positions, pagination, or an as-of reconstruction are temporarily unavailable (`error_code` `positions_unavailable`, `pagination_unavailable`, or `reconstruction_unavailable`). Retry shortly. - `default`: Any other error. The body is an `ErrorResponse`; branch on `error_code`. A 503 (`upstream_unavailable`) carries `Retry-After`. --- [API](https://skmtc.dev/0xarchive/apis/0xarchive-api-2.md) · [All operations](https://skmtc.dev/0xarchive/apis/0xarchive-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/0xarchive/apis/0xarchive-api-2/revisions/27076f55595f?raw)