Skip to main content

API Introduction

Everything you need to get started using HolderScan API.

Base Url:

https://api.holderscan.com/v0/
note

This API is in Beta (V0). Only Solana tokens are currently supported.

Getting Started​

Make sure you have a HolderScan account with Premium or one of our API Plans.

You can review our API Plans here.

Generate an API key​

  • Navigate to your account page here.
    • Click Create New Key, name your Key and Create
tip

Record your API Key in a safe place - you will not be able to access this key again. If you lose this key you will need to create a new one.

Sending a request​

Try sending a request to one of the available endpoints

curl 'https://api.holderscan.com/v0/sol/tokens/63LfDmNb3MQ8mw9MtZ2To9bEA2M71kZUUGq5tiJxcqj9/holders/breakdowns' -H "x-api-key: <your-api-key>"

Example response:

{
  "total_holders": 73760,
  "holders_over_10_usd": 50902,
  "holders_over_100_usd": 33341,
  "holders_over_1000_usd": 12999,
  "holders_over_10000_usd": 3019,
  "holders_over_100k_usd": 711,
  "holders_over_1m_usd": 171,
  "categories": {
    "shrimp": 22858,
    "crab": 17561,
    "fish": 20342,
    "dolphin": 9980,
    "whale": 3019
  }
}