--- title: "Get balance(s)" method: GET path: "/state" tags: ["Chain State"] --- # Get balance(s) `GET /state` Retrieve account balance(s) for one or more addresses at given block(s). Corresponds to the chifra state command line. ## Query parameters - `addrs` string[], required - `blocks` string[] - `parts` string[] - `changes` boolean - `noZero` boolean - `call` boolean - `calldata` string - `articulate` boolean - `proxyFor` string, address - `chain` string - `noHeader` boolean - `cache` boolean - `decache` boolean - `ether` boolean - `fmt` string ## Response `200` returns the requested data - object - `data` union[] — Produces Function, Message, Parameter, Result or State data. Corresponds to the chifra state command line. - union - Function — a human-readable representation of a Solidity function call or event - `name` string, string — the name of the interface - `type` string, string — the type of the interface, either 'event' or 'function' - `signature` string, string — the canonical signature of the interface - `encoding` string, string — the signature encoded with keccak - `inputs` Parameter[] — the input parameters to the function, if any - `type` string, string — the type of this parameter - `name` string, string — the name of this parameter - `strDefault` string, string — the default value of this parameter, if any - `indexed` boolean — `true` if this parameter is indexed - `internalType` string, string — for composite types, the internal type of the parameter - `components` Parameter[] — for composite types, the parameters making up the composite - `outputs` Parameter[] — the output parameters to the function, if any - `type` string, string — the type of this parameter - `name` string, string — the name of this parameter - `strDefault` string, string — the default value of this parameter, if any - `indexed` boolean — `true` if this parameter is indexed - `internalType` string, string — for composite types, the internal type of the parameter - `components` Parameter[] — for composite types, the parameters making up the composite - Message — used for various responses when no real data is generated - `msg` string, string — the message - `num` number — a number if needed - Parameter — an input or output parameter to a Solidity function or event - `type` string, string — the type of this parameter - `name` string, string — the name of this parameter - `strDefault` string, string — the default value of this parameter, if any - `indexed` boolean — `true` if this parameter is indexed - `internalType` string, string — for composite types, the internal type of the parameter - `components` Parameter[] — for composite types, the parameters making up the composite - Result — the result (articulated if possible, as bytes otherwise) of a call to a smart contract - `blockNumber` number — the block number at which this call was made - `timestamp` number — the timestamp of the block for this call - `date` string, datetime — the timestamp as a date (calculated) - `address` string, address — the address of contract being called - `name` string, string — the name of the function call - `encoding` string, string — the encoding for the function call - `signature` string, string — the canonical signature of the interface - `encodedArguments` string, string — the bytes data following the encoding of the call - `articulatedOut` object — the result of the call articulated as other models - State — the state of an Ethereum account (EOA or smart contract) on-chain - `blockNumber` number — the block number at which this call was made - `timestamp` number — the timestamp of the block for this call - `date` string, datetime — the timestamp as a date (calculated) - `address` string, address — the address of contract being called - `accountType` string, string — the type of account at the given block - `balance` string, wei — the balance of the account at the given block - `ether` string, ether — if --ether is specified, the balance in ether (calculated) - `code` string, string — the code of the account - `deployed` number — for smart contracts only, the block number at which the contract was deployed - `nonce` number — the nonce of the account at the given block - `proxy` string, address — the proxy address of the account at the given block ## Other responses - `400` — bad input parameter ## Changes - **2024-12-17** `2428f6f19a07` — 1 breaking, 1 info - for the `query` request parameter `call`, the type/format was changed from `string`/`` to `boolean`/`` - added the new optional `query` request parameter `calldata` - **2024-05-13** `62046cd992aa` — 1 breaking - the `data/items/oneOf[#/components/schemas/state]/nonce` response's property type/format changed from `number`/`nonce` to `number`/`value` for status `200` - **2024-05-08** `1a5ca105dc84` — 1 breaking - the `data/items/oneOf[#/components/schemas/state]/nonce` response's property type/format changed from `number`/`uint64` to `number`/`nonce` for status `200` - **2024-05-03** `bd3425654b91` — 1 breaking, 1 info - the `data/items/oneOf[#/components/schemas/message]/num` response's property type/format changed from `string`/`int` to `number`/`int64` for status `200` - added the optional property `data/items/oneOf[#/components/schemas/state]/ether` to the response with the `200` status - **2024-04-30** `b2da4e150982` — 1 breaking - added `#/components/schemas/function, #/components/schemas/message, #/components/schemas/parameter` to the `data/items/` response property `oneOf` list for the response status `200` [Full history](https://skmtc.dev/trueblocks/apis/trueblocks-api/changes/state/get.md) --- [API](https://skmtc.dev/trueblocks/apis/trueblocks-api.md) · [All operations](https://skmtc.dev/trueblocks/apis/trueblocks-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/trueblocks/trueblocks-api/revisions/2a176f1485a9/schema)