Wallets whose first known activity — the earlier of their first indexed fill and their first reconstructed position lifecycle — is within newcomerDays, and whose gross lifecycle notional over the last 90 days is at least minNotional. Wallets with no trade history whose first lifecycle sits on the lifecycle table's first day are excluded as window-start artefacts.

get/api/public/v1/pulse/newcomer-whales

Request

Query parameters

newcomerDaysinteger
minNotionalnumber double
limitinteger
offsetinteger

Response

OK

firstLifecycleAtstring required

RFC3339 time the first reconstructed position lifecycle opened.

firstSeenstring required

RFC3339. Earliest known activity: min(firstTradeAt, firstLifecycleAt).

firstTradeAtstring nullable required

RFC3339 time of the first indexed fill (trades table, back to 2025-02). null when the wallet has no trade history.

grossNotionalnumber double required
lifecyclesinteger required
totalPnlnumber double required
walletstring required

Changes

    • 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 required property / to the response with the status

    • info

      added the required property / to the response with the status