Skip to main content
The full lifetime record of a wallet of your users. Returns lifetime statistics, a win rate distribution across profit buckets, a per-token overview of everything the wallet has traded, and a paginated log of individual trades, newest first. Where the tracker focuses on a single period, history covers the whole life of the wallet. Use it for a complete profile page, trade exports or deep research on a trader.
The trade log is paginated. Read pagination.next_cursor from the response and pass it back as cursor to fetch the next page. When next_cursor is null you have reached the end. Statistics and the token overview always cover the whole history.
White-Label: unverified wallets of your platform users work here too, while wallet_trust is all. profile.wallet_verified tells you whether the wallet is payment-verified, so you can show a badge. With wallet_trust: verified_only only payment-verified wallets are answered.

Query Parameters

string
required
Chain of the wallet. One of solana, bnb, base, eth, rh.
string
required
A wallet of one of your users on this chain: payment-verified, or an unverified wallet of one of your platform users while your instance’s wallet_trust is all.
string
Only the trades of this token, for example to mark a user’s buys and sells on a token’s price chart. The lifetime stats then cover this token only.
integer
default:"500"
Trades per page in the trade log, 1 to 1000.
string
Cursor for the next page of trades, the pagination.next_cursor from the previous response. Empty means from the newest trade.
string
default:"instance"
global allows any CabalSpy ID wallet. Enterprise plan only.
string
Your Instance ID. Only needed when your account has several instances.
string
required
Your API key. Alternatively pass it as an Authorization Bearer header.

Usage Example

Response

boolean
True on success.
object
object

Errors