hunterlong/tokenbalance

!TokenBalance

TokenBalance API 

TokenBalance是一款易用的公共API和应用，用于查询ERC20余额，无需复杂操作。您可以在本地运行TokenBalance，或使用api.tokenbalance.com快速解析ERC20余额。该工具支持连接本地Geth IPC节点，输出简洁的JSON响应，默认运行在8080端口。

https://github.com/*** https://github.com/*** https://github.com/*** https://github.com/***

服务器状态与 uptime

您可以通过状态页面查看TokenBalance的当前状态及API延迟信息，包含主网、Ropsten测试网和Rinkeby测试网的状态：
[]

核心功能

1. 支持ERC20***余额及ETH余额查询
2. 提供JSON（含***详情）和纯文本（仅余额）两种响应格式
3. 兼容***主网、Ropsten、Rinkeby测试网
4. 可作为Go包集成到自定义应用
5. 支持Google Sheets导入数据

使用场景

• 个人用户快速查询***余额
• 开发者将余额查询功能集成到***应用
• 通过Google Sheets构建加密货币***组合
• 本地部署私有API服务

配置说明

Docker部署

注册免费的Infura.io API Key后，可通过Docker快速启动服务：

bash
docker run -p 8080:8080 -e GETH_SERVER=https://mainnet.infura.io/APIKEY -d hunterlong/tokenbalance

API调用示例

***详情与余额（JSON响应）

***主网

bash
https://api.tokenbalance.com/token/TOKEN_ADDRESS/ETH_ADDRESS

Ropsten测试网

bash
https://test.tokenbalance.com/token/TOKEN_ADDRESS/ETH_ADDRESS

响应示例

json
{
    "name": "Kin",
    "wallet": "0x393c82c7Ae55B48775f4eCcd2523450d291f2418",
    "symbol": "KIN",
    "decimals": 18,
    "balance": "15788648",
    "eth_balance": "0.217960852347180212",
    "block": 4274167
}

仅***余额（纯文本响应）

bash
https://api.tokenbalance.com/balance/TOKEN_ADDRESS/ETH_ADDRESS

响应示例

1022.503000

Go包集成

bash
go get github.com/hunterlong/tokenbalance

代码示例：

go
import (
    "github.com/hunterlong/tokenbalance"
)

func main() {
    // 连接Geth服务器
    configs := &tokenbalance.Config{
        GethLocation: "https://eth.coinapp.io",
        Logs:         true,
    }
    configs.Connect()

    // 输入代币合约地址和钱包地址
    contract := "0x86fa049857e0209aa7d9e616f7eb3b3b78ecfdb0"
    wallet := "0xbfaa1a1ea534d35199e84859975648b59880f639"

    // 查询区块链数据
    token, err := tokenbalance.New(contract, wallet)
    if err != nil {
        // 处理错误
    }

    // 获取结果
    token.BalanceString()  // "600000.0"
    token.ETHString()      // "1.020095885777777767"
    token.Name             // "OmiseGO"
    token.Symbol           // "OMG"
}

Google Sheets集成

在Google Sheets单元格中输入以下公式，即可导入***余额：

=ImportData("https://api.tokenbalance.com/balance/0xd26114cd6EE289AccF82350c8d8487fedB8A0C07/0xf9578adc61d07671f536d50afc5800232fc9fd86")

本地部署

Ubuntu 16.04

bash
git clone https://github.com/hunterlong/tokenbalance
cd tokenbalance
go get && go build ./cmd

启动服务：

bash
tokenbalance start --geth="/***/geth.ipc" --port 8080 --ip 127.0.0.1