How to Filter Solana Token Holders by Value and Quantity (Solscan API)

The Direct Answer:

To filter token holders by the exact quantity of tokens they hold or their total USD value, query the Solscan Pro API Token Holders endpoint (v2.0/token/holders). You can now apply the amount parameters to filter by raw token quantity, or use from_value and to_value to filter holders by their fiat USD value.

Understanding the New Filter Parameters

Instead of fetching all holders and parsing the data locally, you can now command the Solscan API to do the heavy lifting. The v2.0/token/holders endpoint accepts four new query parameters:


Parameter Type Description
from_amount String The minimum token quantity a wallet must hold to appear in the results.
to_amount String The maximum token quantity a wallet can hold.
from_value Number The minimum USD fiat value of the tokens held.
to_value Number The maximum USD fiat value of the tokens held.

Specific Use Cases & Examples

Here is how you can implement these parameters to build advanced analytics or track whale behavior.

Example 1: Finding High-Value "Whale" Holders (Value Filter)

If you want to isolate addresses holding more than $100,000 USD worth of a specific asset, use the from_value parameter. This is highly effective for identifying institutional wallets or major stakeholders without manually calculating token prices.

API Request:

`curl -X 'GET' \
  'https://pro-api.solscan.io/v2.0/token/holders?address=<TOKEN_ADDRESS>&from_value=100000&page=1&page_size=20' \
  -H 'accept: application/json' \
  -H 'token: <YOUR_API_KEY>'`

Example 2: Isolating Specific Allocation Tiers (Quantity Filter)

If you are analyzing an airdrop and want to find mid-tier holders—for example, wallets holding between 1,000,000 and 5,000,000 of a token—you will use the from_amount and to_amount parameters together.

Note: Because token amounts can be extremely large, from_amount and to_amount must be passed as strings.

API Request:

Bash

`curl -X 'GET' \
  'https://pro-api.solscan.io/v2.0/token/holders?address=<TOKEN_ADDRESS>&from_amount=1000000&to_amount=5000000&page=1&page_size=20' \
  -H 'accept: application/json' \
  -H 'token: <YOUR_API_KEY>'`

Developer Tip: Combining Parameters

You can combine these parameters to create hyper-specific queries. However, ensure your pagination (page and page_size) is properly configured, as these filters will dynamically alter the total number of holders returned in the JSON payload.

  • Sinh Nguyen
Updated