Skip to Content
Blockhash Docs
API referenceTokens
GET
/v1/tokens/{address}/traders

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

address*string

A 20-byte hex address.

Match^0x[0-9a-fA-F]{40}$

Query Parameters

window?string

1d reads the last 24 hours, 7d the last 7 days.

Default"1d"

Value in

  • "1d"
  • "7d"
sort?string

pnl ranks by pnlUsd (realized where it is null), bought and sold by the dollars bought or sold in the window.

Default"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"      }    }  }}