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

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

address*string

A 20-byte hex address.

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

Query Parameters

limit?integer

How many holders, largest first. A value out of range reads as its nearest bound.

Range1 <= value <= 100
Default50

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