---
title: "How to Filter Solana Token Holders by Value and Quantity (Solscan API)"
description: "Filter Solana token holders by token quantity or USD value with Solscan Pro API Token Holders endpoint."
url: https://info.solscan.io/solscan-api-filter-solana-token-holders-by-value-and-quantity/
tags: ["Developer"]
published: 2026-04-08
updated: 2026-06-21
---

# 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.