{
  "x402Version": 2,
  "id": 72331,
  "slug": "saylorinnovations-api-evm-token-holders",
  "resource": "https://saylorinnovations.com/api/evm/token-holders",
  "description": "Top holders of an ERC-20 token with labels, balances and share of supply plus top 1, 5, 10 and 20 concentration and a concentration level from Blockscout",
  "type": "http",
  "serviceName": "Saylor Innovations Data Desk",
  "mimeType": "application/json",
  "resourceType": "API",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "eip155:137",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "eip155:42161",
      "payTo": "0xA2A8dF0f7CaaBEa4e120a2568118f141569fc8aa",
      "asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
      "amount": "10000",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "7LSjfrJf8fNsB8VA9u7N3WEn25smQLpob3SvyUvXacy7",
      "asset": "So11111111111111111111111111111111111111112",
      "amount": "95830",
      "amountUsd": 0.01,
      "maxTimeoutSeconds": 120
    }
  ],
  "outputSchema": {
    "type": "object",
    "properties": {
      "chain": {
        "type": "string",
        "description": "Blockchain the data is for"
      },
      "token": {
        "type": "object",
        "description": "Token the values refer to"
      },
      "holders_returned": {
        "type": "number",
        "description": "Holders returned"
      },
      "concentration": {
        "type": "object",
        "description": "Share of supply held by the top 1, 5, 10 and 20 holders, in percent"
      },
      "concentration_level": {
        "type": "string",
        "description": "Concentration level"
      },
      "top_holders": {
        "type": "array",
        "description": "Top holders"
      },
      "note": {
        "type": "string",
        "description": "Caveat or context for reading the result"
      },
      "source": {
        "type": "string",
        "description": "Data source the values come from"
      }
    },
    "required": [
      "chain",
      "token",
      "top_holders"
    ]
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "type": "http",
          "method": "GET",
          "queryParams": {
            "chain": "ethereum",
            "token": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
            "top": "8"
          }
        },
        "output": {
          "type": "json",
          "example": {
            "chain": "ethereum",
            "token": {
              "address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
              "symbol": "USDT",
              "name": "Tether",
              "type": "ERC-20",
              "decimals": 6,
              "holders_total": 16867555,
              "total_supply": 88302633055.7,
              "price_usd": 0.998973,
              "market_cap_usd": 183476474959.88907
            },
            "holders_returned": 50,
            "concentration": {
              "top_1_percent": 18.12,
              "top_5_percent": 42.19,
              "top_10_percent": 47.91,
              "top_20_percent": 53.56
            },
            "concentration_level": "moderate",
            "top_holders": [
              {
                "rank": 1,
                "address": "0xF977814e90dA44bFA03b6295A0616a897441aceC",
                "label": "Binance: Hot Wallet 20",
                "is_contract": false,
                "balance": 16000000001.1342,
                "share_percent": 18.12
              },
              {
                "rank": 2,
                "address": "0x47ac0Fb4F2D84898e4D9E7b4DaB3C24507a6D503",
                "label": "Binance: Binance-Peg Tokens",
                "is_contract": false,
                "balance": 9184997801.4823,
                "share_percent": 10.402
              },
              {
                "rank": 3,
                "address": "0x835678a611B28684005a5e2233695fB6cbbB0007",
                "label": "Binance: Hot Wallet",
                "is_contract": false,
                "balance": 5075257685.2561,
                "share_percent": 5.748
              }
            ],
            "note": "Top holders from Blockscout; the first page covers the largest 50 holders, so concentration figures are exact for the top ranks. Many top holders are exchanges, bridges or burn addresses rather than …",
            "source": "Blockscout"
          }
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "type": "object",
        "properties": {
          "input": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "http"
              },
              "method": {
                "type": "string",
                "enum": [
                  "GET"
                ]
              },
              "queryParams": {
                "type": "object",
                "properties": {
                  "chain": {
                    "type": "string",
                    "description": "ethereum (default), base, optimism, arbitrum, polygon, gnosis"
                  },
                  "token": {
                    "type": "string",
                    "description": "Token contract 0x address"
                  },
                  "top": {
                    "type": "string",
                    "description": "optional 1-50, default 10"
                  }
                },
                "required": [
                  "token"
                ]
              }
            },
            "required": [
              "type",
              "method"
            ],
            "additionalProperties": false
          },
          "output": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "json"
              },
              "example": {
                "type": "object",
                "properties": {
                  "chain": {
                    "type": "string",
                    "description": "Blockchain the data is for"
                  },
                  "token": {
                    "type": "object",
                    "description": "Token the values refer to"
                  },
                  "holders_returned": {
                    "type": "number",
                    "description": "Holders returned"
                  },
                  "concentration": {
                    "type": "object",
                    "description": "Share of supply held by the top 1, 5, 10 and 20 holders, in percent"
                  },
                  "concentration_level": {
                    "type": "string",
                    "description": "Concentration level"
                  },
                  "top_holders": {
                    "type": "array",
                    "description": "Top holders"
                  },
                  "note": {
                    "type": "string",
                    "description": "Caveat or context for reading the result"
                  },
                  "source": {
                    "type": "string",
                    "description": "Data source the values come from"
                  }
                },
                "required": [
                  "chain",
                  "token",
                  "top_holders"
                ]
              }
            },
            "required": [
              "type"
            ]
          }
        },
        "required": [
          "input"
        ]
      }
    }
  },
  "tags": [
    "top holders of a token",
    "token holder concentration check",
    "who holds most of this erc20",
    "whale share of token supply",
    "is this token distributed"
  ],
  "sourceHost": "saylorinnovations.com",
  "lastUpdated": "2026-10-26T22:14:01.888Z",
  "quality": {},
  "metadata": {
    "serviceName": "Saylor Innovations Data Desk",
    "method": "GET",
    "mimeType": "application/json",
    "inputSchema": {
      "type": "object",
      "properties": {
        "chain": {
          "type": "string",
          "description": "ethereum (default), base, optimism, arbitrum, polygon, gnosis"
        },
        "token": {
          "type": "string",
          "description": "Token contract 0x address"
        },
        "top": {
          "type": "string",
          "description": "optional 1-50, default 10"
        }
      },
      "required": [
        "token"
      ]
    },
    "exampleResponse": {
      "chain": "ethereum",
      "token": {
        "address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
        "symbol": "USDT",
        "name": "Tether",
        "type": "ERC-20",
        "decimals": 6,
        "holders_total": 16867555,
        "total_supply": 88302633055.7,
        "price_usd": 0.998973,
        "market_cap_usd": 183476474959.88907
      },
      "holders_returned": 50,
      "concentration": {
        "top_1_percent": 18.12,
        "top_5_percent": 42.19,
        "top_10_percent": 47.91,
        "top_20_percent": 53.56
      },
      "concentration_level": "moderate",
      "top_holders": [
        {
          "rank": 1,
          "address": "0xF977814e90dA44bFA03b6295A0616a897441aceC",
          "label": "Binance: Hot Wallet 20",
          "is_contract": false,
          "balance": 16000000001.1342,
          "share_percent": 18.12
        },
        {
          "rank": 2,
          "address": "0x47ac0Fb4F2D84898e4D9E7b4DaB3C24507a6D503",
          "label": "Binance: Binance-Peg Tokens",
          "is_contract": false,
          "balance": 9184997801.4823,
          "share_percent": 10.402
        },
        {
          "rank": 3,
          "address": "0x835678a611B28684005a5e2233695fB6cbbB0007",
          "label": "Binance: Hot Wallet",
          "is_contract": false,
          "balance": 5075257685.2561,
          "share_percent": 5.748
        }
      ],
      "note": "Top holders from Blockscout; the first page covers the largest 50 holders, so concentration figures are exact for the top ranks. Many top holders are exchanges, bridges or burn addresses rather than …",
      "source": "Blockscout"
    },
    "parameterLocation": "query",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "type": "http",
            "method": "GET",
            "queryParams": {
              "chain": "ethereum",
              "token": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
              "top": "8"
            }
          },
          "output": {
            "type": "json",
            "example": {
              "chain": "ethereum",
              "token": {
                "address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
                "symbol": "USDT",
                "name": "Tether",
                "type": "ERC-20",
                "decimals": 6,
                "holders_total": 16867555,
                "total_supply": 88302633055.7,
                "price_usd": 0.998973,
                "market_cap_usd": 183476474959.88907
              },
              "holders_returned": 50,
              "concentration": {
                "top_1_percent": 18.12,
                "top_5_percent": 42.19,
                "top_10_percent": 47.91,
                "top_20_percent": 53.56
              },
              "concentration_level": "moderate",
              "top_holders": [
                {
                  "rank": 1,
                  "address": "0xF977814e90dA44bFA03b6295A0616a897441aceC",
                  "label": "Binance: Hot Wallet 20",
                  "is_contract": false,
                  "balance": 16000000001.1342,
                  "share_percent": 18.12
                },
                {
                  "rank": 2,
                  "address": "0x47ac0Fb4F2D84898e4D9E7b4DaB3C24507a6D503",
                  "label": "Binance: Binance-Peg Tokens",
                  "is_contract": false,
                  "balance": 9184997801.4823,
                  "share_percent": 10.402
                },
                {
                  "rank": 3,
                  "address": "0x835678a611B28684005a5e2233695fB6cbbB0007",
                  "label": "Binance: Hot Wallet",
                  "is_contract": false,
                  "balance": 5075257685.2561,
                  "share_percent": 5.748
                }
              ],
              "note": "Top holders from Blockscout; the first page covers the largest 50 holders, so concentration figures are exact for the top ranks. Many top holders are exchanges, bridges or burn addresses rather than …",
              "source": "Blockscout"
            }
          }
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "type": "object",
          "properties": {
            "input": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "http"
                },
                "method": {
                  "type": "string",
                  "enum": [
                    "GET"
                  ]
                },
                "queryParams": {
                  "type": "object",
                  "properties": {
                    "chain": {
                      "type": "string",
                      "description": "ethereum (default), base, optimism, arbitrum, polygon, gnosis"
                    },
                    "token": {
                      "type": "string",
                      "description": "Token contract 0x address"
                    },
                    "top": {
                      "type": "string",
                      "description": "optional 1-50, default 10"
                    }
                  },
                  "required": [
                    "token"
                  ]
                }
              },
              "required": [
                "type",
                "method"
              ],
              "additionalProperties": false
            },
            "output": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "json"
                },
                "example": {
                  "type": "object",
                  "properties": {
                    "chain": {
                      "type": "string",
                      "description": "Blockchain the data is for"
                    },
                    "token": {
                      "type": "object",
                      "description": "Token the values refer to"
                    },
                    "holders_returned": {
                      "type": "number",
                      "description": "Holders returned"
                    },
                    "concentration": {
                      "type": "object",
                      "description": "Share of supply held by the top 1, 5, 10 and 20 holders, in percent"
                    },
                    "concentration_level": {
                      "type": "string",
                      "description": "Concentration level"
                    },
                    "top_holders": {
                      "type": "array",
                      "description": "Top holders"
                    },
                    "note": {
                      "type": "string",
                      "description": "Caveat or context for reading the result"
                    },
                    "source": {
                      "type": "string",
                      "description": "Data source the values come from"
                    }
                  },
                  "required": [
                    "chain",
                    "token",
                    "top_holders"
                  ]
                }
              },
              "required": [
                "type"
              ]
            }
          },
          "required": [
            "input"
          ]
        }
      }
    },
    "examples": [
      {
        "label": "Unpaid discovery call",
        "method": "GET",
        "url": "https://saylorinnovations.com/api/evm/token-holders?chain=ethereum&token=0xdAC17F958D2ee523a2206206994597C13D831ec7&top=8",
        "expectedStatus": 402
      }
    ],
    "cacheTtlSeconds": 0,
    "capabilities": [],
    "noAccountRequired": true,
    "noApiKeyRequired": true,
    "sideEffects": "Paid calls settle the advertised payment; see the provider contract for execution behavior.",
    "payment": {
      "protocol": "x402",
      "settlement": "direct-to-provider"
    },
    "provider": {
      "name": "Saylor Innovations",
      "host": "saylorinnovations.com",
      "manifestUrl": "https://saylorinnovations.com/.well-known/x402.json"
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": true,
  "featured": false,
  "provider": {
    "host": "saylorinnovations.com",
    "manifest_name": "Saylor Innovations Knowledge Base",
    "source": "submitted",
    "source_manifest_url": "https://saylorinnovations.com/.well-known/x402.json",
    "submitted_at": "2026-10-26T05:52:02.113Z"
  },
  "exampleResponse": {
    "chain": "string",
    "token": {},
    "holders_returned": 0,
    "concentration": {},
    "concentration_level": "string",
    "top_holders": [
      "value"
    ],
    "note": "string",
    "source": "string"
  }
}