Skip to main content
GET
Positions in a token
Up to 10 wallets’ positions in one token in one call (wallets=w1,w2,…), in the order asked: what each did with the token over the last 365 days and holds now.
  • buys, sells, boughtAmount, soldAmount, boughtUsd and soldUsd: the wallet’s swaps of the token, in USD at the time of each swap. A route through the token counts both legs.
  • avgBuyPriceUsd is the plain average (boughtUsd / boughtAmount).
  • realizedPnlUsd is the profit on what was sold; unrealizedPnlUsd the tokens bought and still held at priceUsd (the price /tokens gives), less their cost; totalPnlUsd the two together.
  • valueUsd is balance × priceUsd only when the token has a pool of at least $1,000 (as holdings).
  • A figure the source could not measure is null, never 0.
The figures come from the source behind the wallet stats; top traders is another source’s view and can differ. A swap shows up within seconds: to follow a wallet live, read again on its balance frame of the wallet channel, no sooner than 3 s after the previous read.

Authorizations

x-api-key
string
header
required

Path Parameters

chain
string
required

sol, eth, bsc, base or robinhood (or an alias or network id)

Example:

"sol"

address
string
required

Token address (mint or contract)

Example:

"DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"

Query Parameters

wallets
string
required

1 to 10 wallet addresses of the chain, comma separated

Response

One position per wallet asked

data
object[]