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; case-insensitive). An address with no indexed Hyperliquid trading history returns 404 with a detail explaining why.

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.