v1

latestOpenAPI 3.1.0GPL 3.02026-07-131857173.1 KB
Chain State

Get balance(s)

Retrieve account balance(s) for one or more addresses at given block(s). Corresponds to the <a href="/chifra/chainstate/#chifra-state">chifra state</a> command line.

get/state

Query parameters

addrsstring[] required

one or more addresses (0x...) from which to retrieve balances

blocksstring[]

an optional list of one or more blocks at which to report balances, defaults to 'latest'

partsstring[]

control which state to export

changesboolean

only report a balance when it changes from one block to the next

noZeroboolean

suppress the display of zero balance accounts

callboolean

write-only call (a query) to a smart contract

calldatastring

for commands (--call or --send), provides the call data (in various forms) for the command (may be empty for --send)

articulateboolean

for commands only, articulate the retrieved data if ABIs can be found

proxyForstring address

for commands only, redirects calls to this implementation

chainstring

the chain to use

noHeaderboolean

suppress the header in the output

cacheboolean

force the results of the query into the cache

decacheboolean

removes related items from the cache

etherboolean

export values in ether

fmtstring

export format, one of [ txt | csv | json ]

Response

returns the requested data

Example response

{
  "blockNumber": 13176226,
  "balance": 258843698360318500,
  "nonce": 115,
  "code": "0x",
  "proxy": "0xd9db270c1b5e3bd161e8c8503c55ceabee709552",
  "address": "0xa1e4380a3b1f749673e270229993ee55f35663b4",
  "deployed": 0,
  "accttype": "EOA",
  "ether": 0.2588436983603185
}