Accounts & Balances

getBalance

Returns the native token balance (ETH, MATIC, SOL, etc.) for a wallet address. Returns the human-readable `balance`, the on-chain integer `balanceRaw` (in wei/lamports), and `decimals`.

curl -X POST https://your-endpoint.simplystaking.xyz/v1 \
  -H "Content-Type: application/json" \

{
  "jsonrpc": "2.0",
  "method": "getBalance",
  "params": {
    "chain": "ethereum",
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "blockHeight": 19834521
  },
  "id": 1
}

Parameters

Name	Required	Description
chain	yes	Network slug
address	yes	Wallet address e.g. 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
blockHeight	no	Historical EVM block number (archive nodes only) e.g. 19834521

Response Fields

Field	Type
`data`	object
`chain`	string
`address`	string
`blockHeight`	integer
`token`	string
`balance`	string
`balanceRaw`	string
`decimals`	integer

Supported Networks

EthereumPolygonBNB ChainOptimismBaseAvalancheArbitrumGnosisMoonbeamLineaHyperliquidSolana

Try It

Base URL

Chain

address *

blockHeight

JSON-RPC Body

{
  "jsonrpc": "2.0",
  "method": "getBalance",
  "params": {
    "chain": "ethereum",
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "blockHeight": 19834521
  },
  "id": 1
}

getTokenBalance

Returns the balance of a specific ERC-20 or SPL token. Pass the token contract (or mint) address. Response includes the decimal-adjusted `balance`, the on-chain integer `balanceRaw`, and the token `decimals` so integrators can do their own arithmetic without a separate metadata call.

curl -X POST https://your-endpoint.simplystaking.xyz/v1 \
  -H "Content-Type: application/json" \

{
  "jsonrpc": "2.0",
  "method": "getTokenBalance",
  "params": {
    "chain": "ethereum",
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "blockHeight": 19834521
  },
  "id": 1
}