GET
/
token
/
{chain}
/
{tokenAddress}
/
holders
curl --request GET \
  --url https://api-dex.chainstream.io/token/{chain}/{tokenAddress}/holders \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "walletAddress": "0x1234567890abcdef",
      "amount": "1000000000000000000",
      "amountInUsd": 1000000000000000000,
      "percentage": "100"
    }
  ],
  "totals": 1000000,
  "next": "eyJpZCI6MTAwfQ==",
  "hasNext": false,
  "hasPrev": false,
  "startCursor": "eyJpZCI6MTAwfQ==",
  "endCursor": "eyJpZCI6MjAwfQ=="
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
chain
enum<string>
required

A chain name listed in supported networks

Available options:
sol,
base
​
tokenAddress
string
required

An address of a token

Example:

"6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN"

Query Parameters

​
cursor
string

Pagination cursor

Example:

"eyJpZCI6MjAwfQ=="

​
limit
number
default:20

Number of results per page

Required range: 1 <= x <= 100

Response

200 - application/json
​
data
object[]
required

List of token holders

​
totals
number

Total number of items

Example:

1000000

​
next
string

Cursor for the next page

Example:

"eyJpZCI6MTAwfQ=="

​
hasNext
boolean
default:false

Indicates if there are more results

​
hasPrev
boolean
default:false

Indicates if there are previous results

​
startCursor
object

Cursor for first item in current page

Example:

"eyJpZCI6MTAwfQ=="

​
endCursor
object

Cursor for last item in current page

Example:

"eyJpZCI6MjAwfQ=="

Was this page helpful?