Skip to main content
GET
Get portfolio stats

Authorizations

X-Monaco-Signature
string
header
required

Ed25519 session-key request signing. Every authenticated request carries three headers: X-Monaco-PublicKey (64-char lowercase-hex session public key), X-Monaco-Timestamp (Unix milliseconds, within 30s of server time), and X-Monaco-Signature (hex ed25519 signature). The signature is over METHOD\npath?query\ntimestamp_ms\nSHA256_hex(body), where the body hash is the SHA-256 of the empty byte string when there is no body. Obtain the session keypair from POST /api/v1/auth/challenge followed by POST /api/v1/auth/verify.

Query Parameters

period
string

Response

OK

period
string | null

Period used for this query

Example:

"30d"

volume
string | null

Total trade volume (sum of quoteVolume)

Example:

"231.81"

totalTrades
string | null

Number of trades in period

Example:

"42"

totalOrders
string | null

Number of orders in period

Example:

"56"

feesPaid
string | null

Total fees paid by user

Example:

"0.12"

pnl
string | null

Legacy realized PnL over the period, average-cost basis: gains/losses booked only when a position is reduced or closed, net of fees, with funding folded in. Excludes unrealized PnL on open positions. For the full PnL picture use totalPnl and pnlBreakdown, whose components follow the gross-of-fees convention instead.

Example:

"-0.01"

totalEquity
string | null

Total equity (sum of all balances)

Example:

"280.93"

spotEquity
string | null

Spot account equity

Example:

"280.93"

perpsEquity
string | null

Perpetuals account equity

Example:

"0.00"

winLossRatio
number<double> | null

Position-level win rate: winning positions over winning + losing positions (break-even excluded). Each position (one flat->open->flat round-trip) is classified once by its net realized PnL after all fees, not per fill. Null when the period has no closed positions.

Example:

0.65

maxDrawdown
string | null

Maximum peak-to-trough drawdown on running PnL

Example:

"0.00"

unrealizedPnl
string | null

Current unrealized PnL across open spot holdings (cost basis vs latest close) and open perp positions (entry vs mark). A live value, independent of the period parameter.

Example:

"12.34"

totalPnl
string | null

Current lifetime total PnL: realized + unrealized - fundingPaid - fees, with realized components gross of fees. A live value, independent of the period parameter; the addends are in pnlBreakdown.

Example:

"10.11"

pnlBreakdown
object

Lifetime PnL components for the authenticated user. The fields satisfy totalPnl = (spotRealized + perpsRealized) + (spotUnrealized + perpsUnrealized) - fundingPaid - fees.