Skip to main content
GET
Get P&L

Authorizations

Authorization
string
header
required

Scoped API key from the Totalis app settings. Each key acts for one account, yours or a maker's, and holds only scopes that account can use. Each operation lists the scopes it requires.

Headers

Origin
string

Required for browser sessions; API keys do not require an Origin.

Query Parameters

range
enum<string>
default:1M

Window of the series: 1D, 1W, 1M (default) or ALL since tracking began.

Available options:
1D,
1W,
1M,
ALL

Response

Your P&L series with one freshness status; points are cumulative atomic USDC strings, or null where a held share had no known value. No shared caching.

Cumulative trading P&L of the account Portfolio shows, computed on read: Core trading plus Combos closed in the deployment's vault. Points are cumulative since tracked_since, not rebased: a window's change is its last point minus its first. Deposits, withdrawals and moves between Core and the vault never move it.

range
enum<string>
required

The requested range, echoed.

Available options:
1D,
1W,
1M,
ALL
tracked_since
string<date-time> | null
required

Start of the account's recorded Core history; P&L is cumulative from here. It does not prove that history is complete: a fill gap, an unbridged cash gap or holdings the history cannot reproduce make the read UNAVAILABLE with tracked_since still set. Null while the wallet is not yet observed, with no points and a STALE context.

points
object[]
required

Ascending instants: the window start (never before tracked_since), every round UTC step boundary inside it (1D every 15 minutes, 1W every hour, 1M every 6 hours, ALL an adaptive step of at most 200 points), then the read time valued at live marks.

Maximum array length: 400
context
object
required

Freshness of this read. as_of is the valuation instant, the last point's at: it values the covered history at that instant's marks, and STALE says a source lags. UNAVAILABLE nulls every point.