Skip to main content
GET
Inspect a wallet's trading context

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

Wallet address to inspect (0x followed by 40 hexadecimal characters). An unindexed address returns 404.

Response

OK

address
string
required

Wallet address.

firstTradeAt
string | null
required

RFC3339 time of the wallet's first indexed fill. null on day/week/month leaderboards.

largestLoss
number<double> | null
required

Most negative single-fill closed PnL, USD (<= 0; 0 when the wallet has no losing fill). null on day/week/month leaderboards.

largestWin
number<double> | null
required

Largest single-fill closed PnL, USD. null on day/week/month leaderboards.

lastTradeAt
string | null
required

RFC3339 time of the wallet's last indexed fill. null on day/week/month leaderboards.

totalFees
number<double> | null
required

All-time fees paid, USD. null on day/week/month leaderboards, which do not compute it.

totalPnl
number<double>
required

Indexed realized PnL, USD; period follows the endpoint.

totalTrades
integer<int64>
required

Indexed fill count, not reconstructed position count.

totalVolume
number<double>
required

Indexed traded notional, USD.

winRate
number<double>
required

Winning fills divided by total fills, percent (0 to 100).

winningTrades
integer<int64>
required

Indexed fills with positive closed PnL.

$schema
string<uri>
read-only

A URL to the JSON Schema for this object.

Example:

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

pnlTier
string

All-time PnL cohort legacy slug, when available.

pnlTierRecent
string

Rolling 30-day PnL cohort legacy slug, when available.

recentPnl
number<double>

Realized PnL over the recent classification window, USD, when available.

recentVolume
number<double>

Traded notional over the recent classification window, USD, when available.

recentWindowEnd
string

Classification window end date (YYYY-MM-DD), not request completion time.

sizeTier
string

All-time size cohort legacy slug, when available.

sizeTierRecent
string

Rolling 30-day size cohort legacy slug, when available.