Skip to main content
GET
Get API public v1 pulse trader by address lifecycle summary

Authorizations

X-API-Key
string
header
required

Create an API key at https://developers.coinversa.ai/keys. REST limits are shared across keys by account; access uses the effective tier of the presented key.

Path Parameters

address
string
required

Query Parameters

coin
string
includeSpot
boolean
default:false
includeCensored
boolean
default:false

Response

OK

address
string
required
avgDurationMs
number<double>
required
avgPnl
number<double>
required
biggestLoss
number<double>
required
biggestWin
number<double>
required
closed
integer<int64>
required
coverage
object
required
firstOpenedAt
string | null
required

RFC3339. null when no lifecycle matched.

lastActivityAt
string | null
required

RFC3339. null when no lifecycle matched.

liquidations
integer<int64>
required

Closed lifecycles that ended in a liquidation; never exceeds closed.

losses
integer<int64>
required

Closed lifecycles with realizedPnl < 0.

maxDurationMs
integer<int64> | null
required

null when there is no closed lifecycle in the window.

minDurationMs
integer<int64> | null
required

null when there is no closed lifecycle in the window.

open
integer<int64>
required
openRealizedPnl
number<double>
required

Realized PnL already booked on still-open lifecycles (partial closes/liquidations); excluded from totalPnl, winRate and biggestWin/Loss.

total
integer<int64>
required
totalBuilderFees
number<double>
required
totalFees
number<double>
required

Fees on closed lifecycles in the window.

totalPnl
number<double>
required

Realized PnL summed over closed lifecycles in the window.

uniqueCoins
integer<int64>
required
winRate
number<double>
required
window
object
required
wins
integer<int64>
required

Closed lifecycles with realizedPnl > 0.

$schema
string<uri>
read-only

A URL to the JSON Schema for this object.

Example:

"https://api.coinversa.ai/schemas/WalletLifecycleSummaryBody.json"