Get historical balance data for a specific account in a contract

get

https://api.fireblocks.io/v1/onchain_data/base_asset_id/{baseAssetId}/contract_address/{contractAddress}/account_address/{accountAddress}/balance_history

Returns the paginated balance history of the specified account in a contract with optional date range and interval filtering.

Path Params

baseAssetId

string

required

The blockchain base assetId

contractAddress

string

required

The contract address

accountAddress

string

required

The account address to get balance history for

Query Params

startDate

date-time

Start date of the time range in ISO 8601 format

endDate

date-time

End date of the time range in ISO 8601 format

interval

string

enum

Defaults to day

Time interval for grouping data

Allowed:

pageCursor

string

Page cursor to get the next page"

pageSize

integer

1 to 100

Number of items per page (max 100), requesting more then 100 will return 100 items

sortBy

string

enum

Defaults to blockTimestamp

Sorting field (enum). Sorting only supported by 'blockTimestamp'

Allowed:

order

string

enum

Defaults to DESC

ASC / DESC ordering (default DESC)

Allowed:

Responses

Language

URL

Request

Response

Choose an example:

application/json

200Successfully retrieved the contract balance history

defaultError Response