Get API public v1 pulse trader by address lifecycle summary

Changed on Sep 23, 2026

get/api/public/v1/pulse/trader/{address}/lifecycle-summary

Request

Base URL
https://api.coinversa.ai
Auth
API key in header X-API-Key
TypeScript
https://skmtc.dev/coinversa/apis/coinversa-api/docs/api/public/v1/pulse/trader/:address/lifecycle-summary/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

addressstring required

Query parameters

coinstring

includeSpotboolean

includeCensoredboolean

Response

$schemastring uri

A URL to the JSON Schema for this object.

addressstring required

avgDurationMsnumber double required

avgPnlnumber double required

biggestLossnumber double required

biggestWinnumber double required

closedinteger required

firstOpenedAtstring nullable required

RFC3339. null when no lifecycle matched.

lastActivityAtstring nullable required

RFC3339. null when no lifecycle matched.

liquidationsinteger required

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

lossesinteger required

Closed lifecycles with realizedPnl < 0.

maxDurationMsinteger nullable required

null when there is no closed lifecycle in the window.

minDurationMsinteger nullable required

null when there is no closed lifecycle in the window.

openinteger required

openRealizedPnlnumber double required

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

totalinteger required

totalBuilderFeesnumber double required

totalFeesnumber double required

Fees on closed lifecycles in the window.

totalPnlnumber double required

Realized PnL summed over closed lifecycles in the window.

uniqueCoinsinteger required

winRatenumber double required

winsinteger required

Closed lifecycles with realizedPnl > 0.

Example response

{
  "$schema": "https://api.coinversa.ai/schemas/WalletLifecycleSummaryBody.json"
}

Changes

Sep 23, 2026f2eba29805e5 Revision changes
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- breaking
  the response property became nullable for the status
- info
  added the non-success response with the status
- info
  removed the non-success response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  the response property became required for the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status

Operation history