Skip to main content
GET
Get holding time and profitability
read is required for one authorized exact link without instrument restrictions. Supply the link, environment, IANA timezone and preset. Optional market and reporting pair_id narrow the cohort. Rolling presets include today and forbid custom dates; preset=custom requires inclusive Gregorian from/to. Positions are selected by final native exit and require verified execution timing, final P&L and positive executed entry cost. Duration starts at the first native entry fill. P&L percentage uses entry cost, not margin. The eight histogram bins use exact P&L sign. Scatter exact mode returns at most 2,000 individual positions; larger cohorts use at most 1,984 count-preserving density groups with actual observed bounds. A group is not a position and does not establish an exact mean or correlation. Preserve state, exclusions and decimal strings; loading does not establish an empty cohort. See Account analytics.

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
exchange_link_id
integer
required
Required range: 1 <= x <= 9007199254740991
​
environment
enum<string>
required
Available options:
live,
demo
​
market
enum<string>
Available options:
all,
spot,
futures
​
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})?$
​
timezone
string
required

User-selected IANA timezone, e.g. Europe/London. Required; do not infer it from server time or locale.

Required string length: 1 - 128
​
preset
enum<string>
required
Available options:
week,
month,
3months,
6months,
year,
custom
​
from
string<date>
Pattern: ^\d{4}-\d{2}-\d{2}$
​
to
string<date>
Pattern: ^\d{4}-\d{2}-\d{2}$

Response

Success

One committed cohort for both charts: completed positions whose final native exit falls in the resolved interval and whose timing, final P&L and positive entry-cost basis are verified. Histogram outcome uses exact P&L sign. loading is not an empty cohort; updating retains coherent committed observations.

​
scope
object
required
​
market
enum<string>
required
Available options:
all,
spot,
futures
​
pair_id
string
required
​
boundaries
object[]
required
​
revision
string
required
​
as_of
integer<int64>
required
​
state
enum<string>
required
Available options:
ready,
loading,
updating,
unavailable
​
timezone
string
required
​
calendar_generation
string
required
​
from
string<date>
required
Pattern: ^\d{4}-\d{2}-\d{2}$
​
to
string<date>
required
Pattern: ^\d{4}-\d{2}-\d{2}$
​
count
integer<int64>
required
Required range: 0 <= x <= 9007199254740991
​
excluded
integer<int64>
required
Required range: 0 <= x <= 9007199254740991
​
histogram
object[]
required
Required array length: 8 elements
​
scatter
object
required