Skip to main content
GET
Get Long/Short exposure history
read is required for one authorized exact link without instrument restrictions. First read the analytics snapshot and copy its membership_revision and direction_revision as revision. Supply the same scope and selected pair. Each page contains at most 2,000 chronological observations within the rolling year. Follow the exclusive before until zero, only as far as the review needs. Reuse the same revision tokens; a stale revision requires a fresh snapshot and restart of the needed history. Never merge pages from different revisions. Closed positions count while they had positive executed Futures exposure. Spot and unfilled positions are excluded. Unknown evidence and a zero/zero ratio remain unavailable; they are not zero exposure or a zero ratio. See Account analytics.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

Required range: 1 <= x <= 9007199254740991
environment
enum<string>
required
Available options:
live,
demo
pair_id
string

Opaque reporting pair_id from liftx_analytics_list_assets; omit for All Assets. Not an executable instrument_id.

Maximum string length: 64
Pattern: ^([a-f0-9]{64})?$
membership_revision
string
required
Required string length: 1 - 128
revision
string
required

Copy direction_revision from the analytics snapshot, not its revision field.

Required string length: 1 - 160
before
integer<int64>
Required range: 1 <= x <= 9007199254740991

Response

Success

Chronological executed-exposure observations, including positions that later closed. before=0 exhausts the rolling one-year window; otherwise copy the exclusive boundary to page backward under the same membership and direction revision. Incomplete evidence never establishes flat exposure.

scope
object
required
pair_id
string
required
state
enum<string>
required
Available options:
ready,
loading,
updating,
unavailable
revision
string
required
membership_revision
string
required
as_of
integer<int64>
required
before
integer<int64>
required
Required range: x >= 0
points
object[]
required
Maximum array length: 2000