Skip to main content
GET /v3/traders/{traderId}/wallets: the fictional trader @tradername, on FOMO, pump.fun and Hyperliquid, owns an SVM wallet and an EVM wallet, both at tier proven, shown as fictional shortened strings 8qNx...vR4m and 0x7aB2...9cF4

​
Find a trader

GET /v3/traders/lookup?handle=… matches the handle on every platform, and every handle an account held in the last 30 days, so a renamed account still answers. Narrow it with platform=fomo, pump or another platform.
  • One handle can match several traders, for example two people with the same handle on two platforms. Check canonical.platforms and sources before you pick one.
  • No match answers 200 with an empty page and up to 5 suggestions. match=closest returns the closest suggestion as the only item, with "match": "closest". A close handle is a guess: check it before you store it.
  • Store the tdr_ id and use it from then on. A trader merged into another one keeps answering, with the old id in canonical.mergedFrom.

​
Wallets

Each wallet lists its owners, and each owner carries a tier: how sure we are that the trader owns the wallet.
  • canonical.walletAvailable on the trader says whether GET /v3/traders/{traderId}/wallets will list a wallet, without a reveal.
  • Listing a trader’s wallets takes one reveal when the page lists a wallet. Reading one wallet takes one reveal when an owner holds a tier other than account, and none when every owner is account or it has no owner.
  • An EVM address matches in any letter case and comes back lowercase.

​
PnL

Illustrative PnL from GET /v3/traders/{traderId}/pnl: total profit over 24h, 7d and 30d across whole wallets on every venue, beside an all-time figure we compute ourselves GET /v3/traders/{traderId}/pnl covers the trader’s verified wallets, whole, on every venue, over 24h, 7d and 30d. all is our own figure. Each window carries realized, unrealized and total, as Amount objects. Read status first:
  • Wallet rule: tiers proven, account and partial only, one wallet per address family, and none that another trader also holds.
  • A ready answer can carry stale: true with a figure up to 7 days old. nextUpdateAt says when a newer one falls due.
  • window=7d keeps one window in the answer.
  • A ready answer takes one reveal and 30,000 credits. Any other status costs 200 credits and no reveal.
For many traders, send up to 100 ids to POST /v3/traders/pnl with { "traderIds": [ … ] }. Each item carries its own status, and only ready items take a reveal. The key needs one reveal left per item before the call starts.