{
  "x402Version": 2,
  "id": 72715,
  "slug": "saylorinnovations-api-chain-token-balances-of",
  "resource": "https://saylorinnovations.com/api/chain/token-balances-of",
  "description": "ERC-20 balances of one token for up to 20 wallets on 16 EVM chains, with each wallet's share of supply and the combined balance.",
  "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": "the chain name that was queried"
      },
      "chain_id": {
        "type": "number",
        "description": "EIP-155 chain id of that network"
      },
      "token": {
        "type": "string",
        "description": "the ERC-20 token"
      },
      "symbol": {
        "type": [
          "string",
          "null"
        ],
        "description": "token symbol"
      },
      "decimals": {
        "type": [
          "number",
          "null"
        ],
        "description": "token decimals"
      },
      "total_supply": {
        "type": [
          "string",
          "null"
        ],
        "description": "total supply in token units"
      },
      "owners_checked": {
        "type": "number",
        "description": "wallets read"
      },
      "combined_balance": {
        "type": [
          "string",
          "null"
        ],
        "description": "sum of the listed wallets"
      },
      "combined_share_of_supply_pct": {
        "type": [
          "number",
          "null"
        ],
        "description": "their combined share of supply, percent"
      },
      "holders": {
        "description": "one entry per wallet",
        "type": [
          "array",
          "null"
        ],
        "items": {
          "type": "object",
          "properties": {
            "owner": {
              "description": "wallet address",
              "type": [
                "string",
                "null"
              ]
            },
            "balance": {
              "description": "balance in token units",
              "type": [
                "string",
                "null"
              ]
            },
            "balance_raw": {
              "description": "balance in base units",
              "type": [
                "string",
                "null"
              ]
            },
            "share_of_supply_pct": {
              "description": "share of total supply, percent",
              "type": [
                "number",
                "null"
              ]
            },
            "status": {
              "description": "holds, zero or unreadable",
              "type": [
                "string",
                "null"
              ]
            }
          }
        }
      },
      "note": {
        "type": "string",
        "description": "plain-language reading of the result"
      },
      "source": {
        "type": "string",
        "description": "where the data was read from or how it was computed"
      }
    },
    "required": [
      "chain",
      "chain_id",
      "token",
      "owners_checked",
      "holders",
      "note",
      "source"
    ]
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "type": "http",
          "method": "GET",
          "queryParams": {
            "chain": "ethereum",
            "owners": "0xF977814e90dA44bFA03b6295A0616a897441aceC,0x28C6c06298d514Db089934071355E5743bf21d60",
            "token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
          }
        },
        "output": {
          "type": "json",
          "example": {
            "chain": "ethereum",
            "chain_id": 1,
            "token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
            "symbol": "USDC",
            "decimals": 6,
            "total_supply": "47666181335.376416",
            "owners_checked": 2,
            "combined_balance": "52159.55272",
            "combined_share_of_supply_pct": 0.0001,
            "holders": [
              {
                "owner": "0xF977814e90dA44bFA03b6295A0616a897441aceC",
                "balance": "142.2445",
                "balance_raw": "142244500",
                "share_of_supply_pct": 0,
                "status": "holds"
              },
              {
                "owner": "0x28C6c06298d514Db089934071355E5743bf21d60",
                "balance": "52017.30822",
                "balance_raw": "52017308220",
                "share_of_supply_pct": 0.0001,
                "status": "holds"
              }
            ],
            "note": "Balances of one token for the wallets you listed, read at the latest block. This is not a holder ranking: it only covers the addresses you pass.",
            "source": "Chain JSON-RPC (ethereum)"
          }
        }
      },
      "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": "chain name (ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, gnosis, linea, scroll, mantle, blast, sonic, celo, berachain, unichain) or chain id"
                  },
                  "owners": {
                    "type": "string",
                    "description": "comma-separated wallet addresses, 1 to 20"
                  },
                  "token": {
                    "type": "string",
                    "description": "the ERC-20 token contract"
                  }
                },
                "required": [
                  "chain",
                  "owners",
                  "token"
                ]
              }
            },
            "required": [
              "type",
              "method"
            ],
            "additionalProperties": false
          },
          "output": {
            "type": "object",
            "properties": {
              "type": {
                "type": "string",
                "const": "json"
              },
              "example": {
                "type": "object",
                "properties": {
                  "chain": {
                    "type": "string",
                    "description": "the chain name that was queried"
                  },
                  "chain_id": {
                    "type": "number",
                    "description": "EIP-155 chain id of that network"
                  },
                  "token": {
                    "type": "string",
                    "description": "the ERC-20 token"
                  },
                  "symbol": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "token symbol"
                  },
                  "decimals": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "token decimals"
                  },
                  "total_supply": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "total supply in token units"
                  },
                  "owners_checked": {
                    "type": "number",
                    "description": "wallets read"
                  },
                  "combined_balance": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "sum of the listed wallets"
                  },
                  "combined_share_of_supply_pct": {
                    "type": [
                      "number",
                      "null"
                    ],
                    "description": "their combined share of supply, percent"
                  },
                  "holders": {
                    "description": "one entry per wallet",
                    "type": [
                      "array",
                      "null"
                    ],
                    "items": {
                      "type": "object",
                      "properties": {
                        "owner": {
                          "description": "wallet address",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "balance": {
                          "description": "balance in token units",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "balance_raw": {
                          "description": "balance in base units",
                          "type": [
                            "string",
                            "null"
                          ]
                        },
                        "share_of_supply_pct": {
                          "description": "share of total supply, percent",
                          "type": [
                            "number",
                            "null"
                          ]
                        },
                        "status": {
                          "description": "holds, zero or unreadable",
                          "type": [
                            "string",
                            "null"
                          ]
                        }
                      }
                    }
                  },
                  "note": {
                    "type": "string",
                    "description": "plain-language reading of the result"
                  },
                  "source": {
                    "type": "string",
                    "description": "where the data was read from or how it was computed"
                  }
                },
                "required": [
                  "chain",
                  "chain_id",
                  "token",
                  "owners_checked",
                  "holders",
                  "note",
                  "source"
                ]
              }
            },
            "required": [
              "type"
            ]
          }
        },
        "required": [
          "input"
        ]
      }
    }
  },
  "tags": [
    "token balance many wallets",
    "whale wallet balances",
    "bulk erc20 balanceof",
    "share of supply held",
    "compare wallet holdings"
  ],
  "sourceHost": "saylorinnovations.com",
  "lastUpdated": "2026-10-26T22:14:01.984Z",
  "quality": {},
  "metadata": {
    "serviceName": "Saylor Innovations Data Desk",
    "method": "GET",
    "mimeType": "application/json",
    "inputSchema": {
      "type": "object",
      "properties": {
        "chain": {
          "type": "string",
          "description": "chain name (ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, gnosis, linea, scroll, mantle, blast, sonic, celo, berachain, unichain) or chain id"
        },
        "owners": {
          "type": "string",
          "description": "comma-separated wallet addresses, 1 to 20"
        },
        "token": {
          "type": "string",
          "description": "the ERC-20 token contract"
        }
      },
      "required": [
        "chain",
        "owners",
        "token"
      ]
    },
    "exampleResponse": {
      "chain": "ethereum",
      "chain_id": 1,
      "token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
      "symbol": "USDC",
      "decimals": 6,
      "total_supply": "47666181335.376416",
      "owners_checked": 2,
      "combined_balance": "52159.55272",
      "combined_share_of_supply_pct": 0.0001,
      "holders": [
        {
          "owner": "0xF977814e90dA44bFA03b6295A0616a897441aceC",
          "balance": "142.2445",
          "balance_raw": "142244500",
          "share_of_supply_pct": 0,
          "status": "holds"
        },
        {
          "owner": "0x28C6c06298d514Db089934071355E5743bf21d60",
          "balance": "52017.30822",
          "balance_raw": "52017308220",
          "share_of_supply_pct": 0.0001,
          "status": "holds"
        }
      ],
      "note": "Balances of one token for the wallets you listed, read at the latest block. This is not a holder ranking: it only covers the addresses you pass.",
      "source": "Chain JSON-RPC (ethereum)"
    },
    "parameterLocation": "query",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "type": "http",
            "method": "GET",
            "queryParams": {
              "chain": "ethereum",
              "owners": "0xF977814e90dA44bFA03b6295A0616a897441aceC,0x28C6c06298d514Db089934071355E5743bf21d60",
              "token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
            }
          },
          "output": {
            "type": "json",
            "example": {
              "chain": "ethereum",
              "chain_id": 1,
              "token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
              "symbol": "USDC",
              "decimals": 6,
              "total_supply": "47666181335.376416",
              "owners_checked": 2,
              "combined_balance": "52159.55272",
              "combined_share_of_supply_pct": 0.0001,
              "holders": [
                {
                  "owner": "0xF977814e90dA44bFA03b6295A0616a897441aceC",
                  "balance": "142.2445",
                  "balance_raw": "142244500",
                  "share_of_supply_pct": 0,
                  "status": "holds"
                },
                {
                  "owner": "0x28C6c06298d514Db089934071355E5743bf21d60",
                  "balance": "52017.30822",
                  "balance_raw": "52017308220",
                  "share_of_supply_pct": 0.0001,
                  "status": "holds"
                }
              ],
              "note": "Balances of one token for the wallets you listed, read at the latest block. This is not a holder ranking: it only covers the addresses you pass.",
              "source": "Chain JSON-RPC (ethereum)"
            }
          }
        },
        "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": "chain name (ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, gnosis, linea, scroll, mantle, blast, sonic, celo, berachain, unichain) or chain id"
                    },
                    "owners": {
                      "type": "string",
                      "description": "comma-separated wallet addresses, 1 to 20"
                    },
                    "token": {
                      "type": "string",
                      "description": "the ERC-20 token contract"
                    }
                  },
                  "required": [
                    "chain",
                    "owners",
                    "token"
                  ]
                }
              },
              "required": [
                "type",
                "method"
              ],
              "additionalProperties": false
            },
            "output": {
              "type": "object",
              "properties": {
                "type": {
                  "type": "string",
                  "const": "json"
                },
                "example": {
                  "type": "object",
                  "properties": {
                    "chain": {
                      "type": "string",
                      "description": "the chain name that was queried"
                    },
                    "chain_id": {
                      "type": "number",
                      "description": "EIP-155 chain id of that network"
                    },
                    "token": {
                      "type": "string",
                      "description": "the ERC-20 token"
                    },
                    "symbol": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "token symbol"
                    },
                    "decimals": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "token decimals"
                    },
                    "total_supply": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "total supply in token units"
                    },
                    "owners_checked": {
                      "type": "number",
                      "description": "wallets read"
                    },
                    "combined_balance": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "sum of the listed wallets"
                    },
                    "combined_share_of_supply_pct": {
                      "type": [
                        "number",
                        "null"
                      ],
                      "description": "their combined share of supply, percent"
                    },
                    "holders": {
                      "description": "one entry per wallet",
                      "type": [
                        "array",
                        "null"
                      ],
                      "items": {
                        "type": "object",
                        "properties": {
                          "owner": {
                            "description": "wallet address",
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "balance": {
                            "description": "balance in token units",
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "balance_raw": {
                            "description": "balance in base units",
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "share_of_supply_pct": {
                            "description": "share of total supply, percent",
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "status": {
                            "description": "holds, zero or unreadable",
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        }
                      }
                    },
                    "note": {
                      "type": "string",
                      "description": "plain-language reading of the result"
                    },
                    "source": {
                      "type": "string",
                      "description": "where the data was read from or how it was computed"
                    }
                  },
                  "required": [
                    "chain",
                    "chain_id",
                    "token",
                    "owners_checked",
                    "holders",
                    "note",
                    "source"
                  ]
                }
              },
              "required": [
                "type"
              ]
            }
          },
          "required": [
            "input"
          ]
        }
      }
    },
    "examples": [
      {
        "label": "Unpaid discovery call",
        "method": "GET",
        "url": "https://saylorinnovations.com/api/chain/token-balances-of?chain=ethereum&token=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&owners=0xF977814e90dA44bFA03b6295A0616a897441aceC,0x28C6c06298d514Db089934071355E5743bf21d60",
        "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",
    "chain_id": 0,
    "token": "string",
    "symbol": "string",
    "decimals": 0,
    "total_supply": "string",
    "owners_checked": 0,
    "combined_balance": "string",
    "combined_share_of_supply_pct": 0,
    "holders": [
      {
        "owner": "string",
        "balance": "string",
        "balance_raw": "string",
        "share_of_supply_pct": 0,
        "status": "string"
      }
    ],
    "note": "string",
    "source": "string"
  }
}