Skip to main content
GET
/
onchain_data
/
base_asset_id
/
{baseAssetId}
/
contract_address
/
{contractAddress}
/
account_address
/
{accountAddress}
/
balance_history
TypeScript
const response: Promise<FireblocksResponse<BalanceHistoryPagedResponse>> = fireblocks.onchainData.getContractBalanceHistory(onchainDataApiGetContractBalanceHistoryRequest);
{
  "data": [
    {
      "timestamp": "2024-01-01T23:59:59.999Z",
      "balance": "1000000000000000000000"
    }
  ],
  "next": "MjAyMy0xMi0xMyAyMDozNjowOC4zMDI=:MTEwMA==",
  "prev": "dGhpcyBpcyBhIHByZXZpb3VzIGN1cnNvcg==",
  "total": 150
}

Path Parameters

​
baseAssetId
string
required

The blockchain base assetId

​
contractAddress
string
required

The contract address

​
accountAddress
string
required

The account address to get balance history for

Example:

"0x1234567890abcdef1234567890abcdef12345678"

Query Parameters

​
startDate
string<date-time>

Start date of the time range in ISO 8601 format

​
endDate
string<date-time>

End date of the time range in ISO 8601 format

​
interval
enum<string>
default:day

Time interval for grouping data

Available options:
hour,
day,
week,
month
​
pageCursor
string

Page cursor to get the next page"

​
pageSize
integer

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

Required range: 1 <= x <= 100
​
sortBy
enum<string>
default:blockTimestamp

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

Available options:
blockTimestamp
​
order
enum<string>
default:DESC

ASC / DESC ordering (default DESC)

Available options:
ASC,
DESC

Response

Successfully retrieved the contract balance history

​
data
object[]
required

Array of balance history data points

​
next
string

Cursor for next page

Example:

"MjAyMy0xMi0xMyAyMDozNjowOC4zMDI=:MTEwMA=="

​
prev
string

Cursor for previous page

Example:

"dGhpcyBpcyBhIHByZXZpb3VzIGN1cnNvcg=="

​
total
number

Total count of items

Example:

150