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.
Path Parameters
A 20-byte hex address.
^0x[0-9a-fA-F]{40}$Query Parameters
How many holders, largest first. A value out of range reads as its nearest bound.
1 <= value <= 10050Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/tokens/string/holders/pnl"{ "token": "string", "holders": 0, "priceUsd": 0, "priceConfidence": "string", "totalSupply": "string", "decimals": 0, "top10Share": 0, "top": [ { "holder": "string", "balance": "string", "share": 0, "valueUsd": 0, "label": { "kind": "burn", "name": "string" }, "pnl": { "bought": { "amount": 0, "usd": 0, "txs": 0 }, "sold": { "amount": 0, "usd": 0, "txs": 0 }, "received": { "amount": 0, "txs": 0 }, "sent": { "amount": 0, "txs": 0 }, "costBasisUsd": 0, "avgCostUsd": 0, "realizedUsd": 0, "unrealizedUsd": 0, "totalUsd": 0, "estimated": true, "firstAt": 0, "lastAt": 0 }, "pnlWhy": "contract" } ], "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" } } }}Get a token's trading windows GET
A token's trading over the last 5 minutes, hour, 6 hours and day, across every pool it trades in: its swaps by side, their dollar volumes, and the wallets behind them. They are read at most once in 30 seconds a token and may be up to two minutes old: `asOf` names the second they were read.
List a token's top traders GET
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`.