v1

latestOpenAPI 3.1.02026-07-2411205.0 MB

Get Account History

Gives most recent coldkey balance (from the database)

get/api/account/history/v1

Query parameters

addressstring required

Address String to query

network'finney' | 'nakamoto' | 'kusanagi'

Finney is the current network. nalamoto and kusanagi added for historical data.

block_numberinteger

Block for data

block_startinteger

block number for start of range

block_endinteger

block number for end of range

timestamp_startinteger

Start of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive)

timestamp_endinteger

End of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive)

order'block_number_asc' | 'block_number_desc' | 'timestamp_asc' | 'timestamp_desc'

pageinteger

Page of entries to retrieve.

limitinteger

Number of entries to return. Max value is 200.

Response

200

Example response

{
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total_items": 708,
    "total_pages": 15,
    "next_page": 2
  },
  "data": [
    {
      "address": {
        "ss58": "5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS",
        "hex": "0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752"
      },
      "network": "finney",
      "block_number": 5007431,
      "timestamp": "2025-02-25T23:59:48Z",
      "balance_free": "12443252",
      "balance_staked": "327659746222",
      "balance_staked_alpha_as_tao": "75599415",
      "balance_staked_root": "327584146807",
      "balance_total": "327672189474",
      "created_on_date": "2023-03-21",
      "created_on_network": "finney"
    }
  ]
}