COcoinversa
Wallet intelligence

Inspect a wallet's trading context

Changed on

Fetch the indexed trader profile for a wallet. Combine it with the WebSocket tradesByUser feed to follow wallet activity. Trade statistics describe indexed fills; a successful lookup does not establish that a stream is connected. A syntactically valid example address may have no indexed profile (404). Use a wallet you intend to inspect.

get/api/public/v1/pulse/trader/{address}

Request

Path parameters

addressstring 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

$schemastring uri

A URL to the JSON Schema for this object.

addressstring required

Wallet address.

firstTradeAtstring nullable required

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

largestLossnumber double nullable required

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

largestWinnumber double nullable required

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

lastTradeAtstring nullable required

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

pnlTierstring

All-time PnL cohort legacy slug, when available.

pnlTierRecentstring

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

recentPnlnumber double

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

recentVolumenumber double

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

recentWindowEndstring

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

sizeTierstring

All-time size cohort legacy slug, when available.

sizeTierRecentstring

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

totalFeesnumber double nullable required

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

totalPnlnumber double required

Indexed realized PnL, USD; period follows the endpoint.

totalTradesinteger required

Indexed fill count, not reconstructed position count.

totalVolumenumber double required

Indexed traded notional, USD.

winRatenumber double required

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

winningTradesinteger required

Indexed fills with positive closed PnL.

Example response

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

Changes

  • f2eba29805e5Revision 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

    • breaking

      the response property became nullable for the status

    • info

      api tag Wallet intelligence added

    • 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

      added the optional property to the response with the status