GET
/
addresses
/
{hash}
/
account-balances
/
historical
Account Balance Historical
curl --request GET \
  --url https://api.amberdata.com/blockchains/addresses/{hash}/account-balances/historical \
  --header 'x-api-key: <api-key>'
{
  "status": 200,
  "title": "OK",
  "description": "Successful request",
  "payload": {
    "data": [
      [
        "0x06012c8cf97bead5deae237070f9587f8e7a266d",
        "7446815",
        1553638828000,
        0,
        "65183168478133965282"
      ]
    ],
    "metadata": {
      "columns": [
        "address",
        "blockNumber",
        "timestamp",
        "timestampNanoseconds",
        "value"
      ],
      "totalRecords": 1118325
    }
  }
}

Authorizations

​
x-api-key
string
header
required

Headers

​
x-amberdata-blockchain-id
enum<string>
default:ethereum-mainnet

The id of the blockchain

Available options:
bitcoin-mainnet,
bitcoin-abc-mainnet,
ethereum-mainnet,
litecoin-mainnet,
polygon-mainnet

Path Parameters

​
hash
string
default:0x06012c8cf97bead5deae237070f9587f8e7a266d
required

The address to retrieve the account balances for

Query Parameters

​
blockNumber
integer

FIlter by account balances at block number

​
startDate
string<date-time>

FIlter by account balances which happened after this date

​
endDate
string<date-time>

FIlter by account balances which happened before this date

​
value
integer

FIlter by account balances where the balance is equal to this value

​
valueGt
integer

FIlter by account balances where the balance is greater than this value

​
valueGte
integer

FIlter by account balances where the balance is greater than or equal to this value

​
valueLt
integer

FIlter by account balances where the balance is less than this value

​
valueLte
integer

FIlter by account balances where the balance is less than or equal to this value

​
includePrice
boolean

Indicates whether or not to include price data with the results. Options: true, false.

​
currency
string

The currency of the price information (usd or btc.) - only used in conjunction with includePrice.

​
page
integer
default:0

The page number to return.

​
size
integer
default:50

Number of records per page

​
timeFormat
string

[Optional] Time format of the timestamps in the return payload.<BR/>[Defaults] milliseconds | ms* | iso | iso8601 | hr | human_readable

Response

200
application/json

OK

The response is of type object.