Skip to main content
GET
Get maker performance

Authorizations

Authorization
string
header
required

Scoped API key (ttk_...), created in the Totalis app or by a wallet-session user through the API keys routes with a fresh wallet signature; those routes never accept a key. 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. Send no Origin.

Scopes

vault:read

Headers

Origin
string

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

Path Parameters

maker_id
string<uint64-decimal>
required

On-chain maker ID, as a decimal string. An API key may only name the maker it is bound to; other makers return 404.

Maximum string length: 20
Pattern: ^(0|[1-9][0-9]{0,18}|1[0-7][0-9]{18}|18[0-3][0-9]{17}|184[0-3][0-9]{16}|1844[0-5][0-9]{15}|18446[0-6][0-9]{14}|184467[0-3][0-9]{13}|1844674[0-3][0-9]{12}|184467440[0-6][0-9]{10}|1844674407[0-2][0-9]{9}|18446744073[0-6][0-9]{8}|1844674407370[0-8][0-9]{6}|18446744073709[0-4][0-9]{5}|184467440737095[0-4][0-9]{4}|18446744073709550[0-9]{3}|18446744073709551[0-5][0-9]{2}|1844674407370955160[0-9]|1844674407370955161[0-5])$

Query Parameters

from
string<date-time>
required

Inclusive RFC3339 start of the performance period.

through
string<date-time>
required

Exclusive RFC3339 end of the performance period; must be after from.

Response

Complete periods aggregate the positions that closed economically in them; incomplete periods return unavailable metrics. Gas stays unavailable until the payer of every transaction receipt is attributed. Scoped read with one freshness status; amounts are atomic USDC strings or null. No shared caching.

Maker realized performance for a period. Every period aggregate is null unless the whole period is covered by reconciled history.

context
object
required

Freshness of this read: the oldest source observation and one status for every amount in the response.

from
string<date-time>
required

Inclusive RFC3339 start of the requested period, echoed from the query.

through
string<date-time>
required

Exclusive RFC3339 end of the requested period, echoed from the query.

recognition
any
required

P&L recognition rule: realized at economic close (settlement or sell-back), version 1. Claims do not recognize P&L again.

history_from
string<date-time> | null
required

Earliest from this maker's periods can start at and still be complete: the later of where retained vault history and venue workflows begin, or the maker's opening block if later still. Request from=history_from for an all-time period. Null while vault history is unavailable.

closed_ticket_count
string | null
required

Tickets economically closed in the period, as a decimal string; null when settled_net_stake is null.

Pattern: ^(0|[1-9][0-9]{0,77})$
won_ticket_count
string | null
required

Closes in the period the maker won (positive maker P&L), as a decimal string; null exactly when closed_ticket_count is null.

Pattern: ^(0|[1-9][0-9]{0,77})$
lost_ticket_count
string | null
required

Closes in the period the maker lost (negative maker P&L), as a decimal string; null exactly when closed_ticket_count is null.

Pattern: ^(0|[1-9][0-9]{0,77})$
even_ticket_count
string | null
required

Closes in the period with zero maker P&L, as a decimal string; null exactly when closed_ticket_count is null. Won, lost and even add up to closed_ticket_count.

Pattern: ^(0|[1-9][0-9]{0,77})$
settled_net_stake
string | null
required

Net stake released by economic closes in the period.

Pattern: ^(0|[1-9][0-9]{0,77})$
gross_trading_pnl
string | null
required

Signed maker trading P&L from closes in the period (net stake minus effective payout).

Pattern: ^(0|-?[1-9][0-9]{0,77})$
gross_winning_pnl
string | null
required

Sum of the maker P&L of the period's closes the maker won (each positive), so never negative. gross_winning_pnl + gross_losing_pnl = gross_trading_pnl; profit factor is gross_winning_pnl / -gross_losing_pnl.

Pattern: ^(0|-?[1-9][0-9]{0,77})$
gross_losing_pnl
string | null
required

Sum of the maker P&L of the period's closes the maker lost (each negative), so never positive.

Pattern: ^(0|-?[1-9][0-9]{0,77})$
attributed_fees
string | null
required

Fees the maker paid in the period. Taker fees are not maker expenses.

Pattern: ^(0|[1-9][0-9]{0,77})$
net_trading_pnl
string | null
required

Signed gross_trading_pnl minus attributed_fees.

Pattern: ^(0|-?[1-9][0-9]{0,77})$
external_inflows
string | null
required

Deposits into the maker vault in the period; never P&L.

Pattern: ^(0|[1-9][0-9]{0,77})$
external_outflows
string | null
required

Executed maker withdrawals in the period; never P&L.

Pattern: ^(0|[1-9][0-9]{0,77})$
series
object[]

Cumulative net realized P&L at UTC day boundaries within the requested interval, from the same revision as totals, in atomic USDC (6 decimals, "1000000" = 1 USDC): the opening zero point at from, one point per UTC day with closes or maker-paid fees, then through if no day ends there. Each point carries the closes since the previous one, so a day with closes is told apart from the synthetic endpoints. Empty when net_trading_pnl is null.