Skip to content
GET /v1/holders

Largest holders + top-10 supply concentration

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/honeypot-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/honeypot-api/v1/holders" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/honeypot-api/v1/holders", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/honeypot-api/v1/holders");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/honeypot-api/v1/holders",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "note": "The largest holders of an EVM token and how concentrated its supply is. top10_concentration_pct is the share of total supply held by the ten biggest wallets — a high figure means a few wallets could dump the token on you (note some top holders are the liquidity pool or known CEX wallets, flagged via alias/is_contract). supply_pct is each holder's share. balance is the raw on-chain amount (apply token decimals for a human figure). Pass address, chain and limit (1-50). Live.",
        "chain": "Ethereum",
        "count": 20,
        "source": "honeypot.is public API (api.honeypot.is/v1/TopHolders), keyless",
        "address": "0x6982508145454Ce325dDbE47a25d4ec3d2311933",
        "holders": [
            {
                "alias": null,
                "address": "0xf977814e90da44bfa03b6295a0616a897441acec",
                "balance": "40000000000000000000000000000000",
                "supply_pct": 9.5082,
                "is_contract": false
            },
            {
                "alias": null,
                "address": "0x5a52e96bacdabb82fd05763e25335261b270efcb",
                "balance": "33141296548784849877378668900100",
                "supply_pct": 7.8778,
                "is_contract": false
            },
            {
                "alias": null,
                "address": "0x1d48963dd8fada6ab5c2c7b92eba81ecc5030270",
                "balance": "28424454468599944748790607839220",
                "supply_pct": 6.7566,
                "is_contract": false
            },
            {
                "alias": null,
                "address": "0x3f9a8345729ea842708e080e238c92731e5699b8",
                "balance": "15106826498227278586742131868515",
                "supply_pct": 3.591,
                "is_contract": false
            },
            {
                "alias": null,
                "address": "0x611f7bf868a6212f871e89f7e44684045ddfb09d",
                "balance": "13866267870149525164791531110000",
                "supply_pct": 3.2961,
                "is_contract": false
            },
            {
                "alias": null,
                "address": "0xc671b05671a7cd3080c6ceae79d284bdde0ef271",
                "balance": "9559902433932399148356665292413",
                "supply_pct": 2.2724,
                "is_contract": false
            },
            {
                "alias": null,
                "address": "0x15da7556d5ed888306839bed06f868aeaedcb0d7",
                "balance": "9073343691353832060906002600000",
                "supply_pct": 2.1568,
                "is_contract": false
            },
            {
                "alias": null,
                "address": "0x76ec5a0d3632b2133d9f1980903305b62678fbd3",
                "balance": "8164196827630296637833530999119",
                "supply_pct": 1.9407,
                "is_contract": false
            },
            {
                "alias": null,
                "address": "0x000000000000000000000000000
…