Up to 100 wallets that traded a token over the last day or week, ranked by what their trades in the window made, or by what they bought or sold. A sale of tokens held from before the window makes no PnL and is told apart (soldFromBefore). Wrapped ether and dollar tokens answer available: false.
Path Parameters
A 20-byte hex address.
^0x[0-9a-fA-F]{40}$Query Parameters
1d reads the last 24 hours, 7d the last 7 days.
"1d"Value in
- "1d"
- "7d"
pnl ranks by pnlUsd (realized where it is null), bought and sold by the dollars bought or sold in the window.
"pnl"Value in
- "pnl"
- "bought"
- "sold"
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/tokens/string/traders"{ "token": "string", "available": true, "window": "1d", "sort": "pnl", "priceUsd": 0, "priceConfidence": "string", "decimals": 0, "traders": [ { "wallet": "string", "bought": { "amount": 0, "usd": 0, "txs": 0 }, "sold": { "amount": 0, "usd": 0, "txs": 0 }, "realizedUsd": 0, "unrealizedUsd": 0, "pnlUsd": 0, "heldFromWindow": 0, "movedOut": 0, "soldFromBefore": { "amount": 0, "usd": 0 }, "balance": "string", "valueUsd": 0, "firstAt": 0, "lastAt": 0 } ], "readAt": 0, "source": "indexer", "users": { "property1": { "address": "string", "username": "string", "displayName": "string", "avatar": "string", "verified": { "basis": "x-followers" }, "x": { "username": "string" } }, "property2": { "address": "string", "username": "string", "displayName": "string", "avatar": "string", "verified": { "basis": "x-followers" }, "x": { "username": "string" } } }}List a token's holders with their PnL GET
A token's largest holders, each with its balance, its share of the supply, its worth and what it made on the token at average cost. Holders are read once in five minutes a token; worth and unrealized are priced as asked. A pool or contract carries a `label` and no `pnl`.
List a wallet's balances GET
Every positive balance the wallet holds (ERC-20, ERC-721 and ERC-1155), read from every transfer on the chain, largest first. Balances are exact integers as strings: scale them by `decimals` where present.