hmy_getBalance

GetBalance

Get latest balance of an address.

API v1

Parameters

  1. String - The address to get the balance of.

  2. String - Block to get query for balance

Returns

  • String - The current balance for the given address in ATTO.

Sample Curl Request

curl -d '{
    "id": "1",
    "jsonrpc": "2.0",
    "method": "hmy_getBalance",
    "params": [
        "one1z05g55zamqzfw9qs432n33gycdmyvs38xjemyl", 
        "0x1"
    ]
}' -H "Content-Type:application/json" -X POST "https://api.s0.b.hmny.io"

Sample Curl Response

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x6046f35fca29af800"
}

API v2

Parameters

  1. String - The address to get the balance of

Returns

  • String - The current big.Int balance for the given address.

Sample Curl Request

curl -d '{
    "id": "1",
    "jsonrpc": "2.0",
    "method": "hmyv2_getBalance",
    "params": [
        "one1z05g55zamqzfw9qs432n33gycdmyvs38xjemyl"
    ]
}' -H "Content-Type:application/json" -X POST "https://api.s0.b.hmny.io"

Sample Curl Response

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "1000000000000"
}

If Node.js is installed on your system, one easy way to convert hexadecimal balances into a more readable decimal format is to run node -e "console.log(<balance> / 1e18)"

Last updated