Skip to content
Taostats Docs

Get Account History

Endpoint

Section titled “Endpoint”
GET /api/account/history/v1

Description

Section titled “Description”

Gives most recent coldkey balance (from the database)

Parameters

Section titled “Parameters”
NameInTypeRequiredDescription
addressquerystring✅SS58 or hex format
networkquerystringfinney, nakamoto, kusanagi
block_startqueryintegerStart of block range (inclusive)
block_endqueryintegerEnd of block range (inclusive)
timestamp_startqueryintegerStart of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive)
timestamp_endqueryintegerEnd of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive)
pagequeryintegerPage of entries to retrieve.
limitqueryintegerNumber of entries to return. Max value is 200.
orderquery—

Responses

Section titled “Responses”

200 — Account history retrieved successfully

Section titled “200 — Account history retrieved successfully”

Media: application/json

Schema
{
  "type": "object",
  "required": [
    "pagination",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "address",
          "network",
          "block_number",
          "timestamp",
          "rank",
          "balance_free",
          "balance_reserved",
          "balance_staked",
          "balance_staked_alpha_as_tao",
          "balance_staked_root",
          "balance_liquidity",
          "balance_total",
          "root_claim_type",
          "created_on_date",
          "created_on_network"
        ],
        "properties": {
          "address": {
            "type": "object",
            "required": [
              "ss58",
              "hex"
            ],
            "properties": {
              "hex": {
                "type": "string",
                "description": "The hex format of the hot key"
              },
              "ss58": {
                "type": "string",
                "description": "The SS58 format of the hot key"
              }
            }
          },
          "balance_free": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "balance_liquidity": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "balance_reserved": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "balance_staked": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "balance_staked_alpha_as_tao": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "balance_staked_root": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "balance_total": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "block_number": {
            "type": "integer",
            "format": "int32"
          },
          "coldkey_swap": {
            "allOf": [
              {
                "type": "object",
                "required": [
                  "old_coldkey",
                  "new_coldkey",
                  "network",
                  "block_number",
                  "timestamp"
                ],
                "properties": {
                  "block_number": {
                    "type": "integer",
                    "format": "int32"
                  },
                  "network": {
                    "type": "string"
                  },
                  "new_coldkey": {
                    "type": "object",
                    "required": [
                      "ss58",
                      "hex"
                    ],
                    "properties": {
                      "hex": {
                        "type": "string",
                        "description": "The hex format of the hot key"
                      },
                      "ss58": {
                        "type": "string",
                        "description": "The SS58 format of the hot key"
                      }
                    }
                  },
                  "old_coldkey": {
                    "type": "object",
                    "required": [
                      "ss58",
                      "hex"
                    ],
                    "properties": {
                      "hex": {
                        "type": "string",
                        "description": "The hex format of the hot key"
                      },
                      "ss58": {
                        "type": "string",
                        "description": "The SS58 format of the hot key"
                      }
                    }
                  },
                  "timestamp": {
                    "type": "string",
                    "format": "date-time"
                  }
                }
              }
            ],
            "nullable": true
          },
          "created_on_date": {
            "type": "string",
            "format": "date"
          },
          "created_on_network": {
            "type": "string"
          },
          "network": {
            "type": "string"
          },
          "rank": {
            "type": "integer",
            "format": "int32"
          },
          "root_claim_type": {
            "type": "string"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          }
        }
      }
    },
    "pagination": {
      "type": "object",
      "required": [
        "current_page",
        "per_page",
        "total_items",
        "total_pages"
      ],
      "properties": {
        "current_page": {
          "type": "integer",
          "format": "int32"
        },
        "next_page": {
          "type": "integer",
          "format": "int32",
          "nullable": true
        },
        "per_page": {
          "type": "integer",
          "format": "int32"
        },
        "prev_page": {
          "type": "integer",
          "format": "int32",
          "nullable": true
        },
        "total_items": {
          "type": "integer",
          "format": "int32"
        },
        "total_pages": {
          "type": "integer",
          "format": "int32"
        }
      }
    }
  }
}
Examples
{
  "Result": {
    "value": "{\n  \"pagination\": {\n    \"current_page\": 1,\n    \"per_page\": 50,\n    \"total_items\": 708,\n    \"total_pages\": 15,\n    \"next_page\": 2,\n    \"prev_page\": null\n  },\n  \"data\": [\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 5007431,\n      \"timestamp\": \"2025-02-25T23:59:48Z\",\n      \"rank\": 0,\n      \"balance_free\": \"12443252\",\n      \"balance_staked\": \"327659746222\",\n      \"balance_staked_alpha_as_tao\": \"75599415\",\n      \"balance_staked_root\": \"327584146807\",\n      \"balance_total\": \"327672189474\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 5000231,\n      \"timestamp\": \"2025-02-24T23:59:48.001Z\",\n      \"rank\": 0,\n      \"balance_free\": \"6029953\",\n      \"balance_staked\": \"340138134110\",\n      \"balance_staked_alpha_as_tao\": \"74802571\",\n      \"balance_staked_root\": \"340063331539\",\n      \"balance_total\": \"340144164063\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4993036,\n      \"timestamp\": \"2025-02-23T23:59:48Z\",\n      \"rank\": 0,\n      \"balance_free\": \"34902426\",\n      \"balance_staked\": \"353685275338\",\n      \"balance_staked_alpha_as_tao\": \"93448733\",\n      \"balance_staked_root\": \"353591826605\",\n      \"balance_total\": \"353720177764\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4985836,\n      \"timestamp\": \"2025-02-22T23:59:48Z\",\n      \"rank\": 0,\n      \"balance_free\": \"34902426\",\n      \"balance_staked\": \"353382682014\",\n      \"balance_staked_alpha_as_tao\": \"109918386\",\n      \"balance_staked_root\": \"353272763628\",\n      \"balance_total\": \"353417584440\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4978636,\n      \"timestamp\": \"2025-02-21T23:59:48Z\",\n      \"rank\": 0,\n      \"balance_free\": \"34902426\",\n      \"balance_staked\": \"353057619449\",\n      \"balance_staked_alpha_as_tao\": \"101841943\",\n      \"balance_staked_root\": \"352955777506\",\n      \"balance_total\": \"353092521875\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4971436,\n      \"timestamp\": \"2025-02-20T23:59:48.001Z\",\n      \"rank\": 0,\n      \"balance_free\": \"34902426\",\n      \"balance_staked\": \"352741948289\",\n      \"balance_staked_alpha_as_tao\": \"112082186\",\n      \"balance_staked_root\": \"352629866103\",\n      \"balance_total\": \"352776850715\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4964236,\n      \"timestamp\": \"2025-02-19T23:59:48Z\",\n      \"rank\": 0,\n      \"balance_free\": \"34902426\",\n      \"balance_staked\": \"352401230824\",\n      \"balance_staked_alpha_as_tao\": \"144544889\",\n      \"balance_staked_root\": \"352256685935\",\n      \"balance_total\": \"352436133250\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4957036,\n      \"timestamp\": \"2025-02-18T23:59:48.001Z\",\n      \"rank\": 0,\n      \"balance_free\": \"47601234\",\n      \"balance_staked\": \"351901644581\",\n      \"balance_staked_alpha_as_tao\": \"150928068\",\n      \"balance_staked_root\": \"351750716513\",\n      \"balance_total\": \"351949245815\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4949836,\n      \"timestamp\": \"2025-02-17T23:59:48.001Z\",\n      \"rank\": 0,\n      \"balance_free\": \"47601234\",\n      \"balance_staked\": \"351601905323\",\n      \"balance_staked_alpha_as_tao\": \"90705458\",\n      \"balance_staked_root\": \"351511199865\",\n      \"balance_total\": \"351649506557\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4942636,\n      \"timestamp\": \"2025-02-16T23:59:48Z\",\n      \"rank\": 0,\n      \"balance_free\": \"47601234\",\n      \"balance_staked\": \"351365372405\",\n      \"balance_staked_alpha_as_tao\": \"56083006\",\n      \"balance_staked_root\": \"351309289399\",\n      \"balance_total\": \"351412973639\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4935436,\n      \"timestamp\": \"2025-02-15T23:59:48Z\",\n      \"rank\": 0,\n      \"balance_free\": \"47601234\",\n      \"balance_staked\": \"351156676341\",\n      \"balance_staked_alpha_as_tao\": \"36797824\",\n      \"balance_staked_root\": \"351119878517\",\n      \"balance_total\": \"351204277575\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4928236,\n      \"timestamp\": \"2025-02-14T23:59:48Z\",\n      \"rank\": 0,\n      \"balance_free\": \"47601234\",\n      \"balance_staked\": \"350916891481\",\n      \"balance_staked_alpha_as_tao\": \"52948234\",\n      \"balance_staked_root\": \"350863943247\",\n      \"balance_total\": \"350964492715\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4921036,\n      \"timestamp\": \"2025-02-13T23:59:48.001Z\",\n      \"rank\": 0,\n      \"balance_free\": \"47601234\",\n      \"balance_staked\": \"350529342172\",\n      \"balance_staked_alpha_as_tao\": \"68501092\",\n      \"balance_staked_root\": \"350460841080\",\n      \"balance_total\": \"350576943406\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4913846,\n      \"timestamp\": \"2025-02-12T23:59:48Z\",\n      \"rank\": 0,\n      \"balance_free\": \"173850746\",\n      \"balance_staked\": \"350164491845\",\n      \"balance_staked_alpha_as_tao\": \"0\",\n      \"balance_staked_root\": \"0\",\n      \"balance_total\": \"350338342591\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4906646,\n      \"timestamp\": \"2025-02-11T23:59:48.001Z\",\n      \"rank\": 0,\n      \"balance_free\": \"341685\",\n      \"balance_staked\": \"411924050114\",\n      \"balance_staked_alpha_as_tao\": \"0\",\n      \"balance_staked_root\": \"0\",\n      \"balance_total\": \"411924391799\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4899446,\n      \"timestamp\": \"2025-02-10T23:59:48Z\",\n      \"rank\": 0,\n      \"balance_free\": \"341685\",\n      \"balance_staked\": \"411727770257\",\n      \"balance_staked_alpha_as_tao\": \"0\",\n      \"balance_staked_root\": \"0\",\n      \"balance_total\": \"411728111942\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4892436,\n      \"timestamp\": \"2025-02-09T23:59:48Z\",\n      \"rank\": 0,\n      \"balance_free\": \"341685\",\n      \"balance_staked\": \"411528473520\",\n      \"balance_staked_alpha_as_tao\": \"0\",\n      \"balance_staked_root\": \"0\",\n      \"balance_total\": \"411528815205\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4885596,\n      \"timestamp\": \"2025-02-08T23:59:48Z\",\n      \"rank\": 0,\n      \"balance_free\": \"341685\",\n      \"balance_staked\": \"411337647405\",\n      \"balance_staked_alpha_as_tao\": \"0\",\n      \"balance_staked_root\": \"0\",\n      \"balance_total\": \"411337989090\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4878757,\n      \"timestamp\": \"2025-02-07T23:59:48Z\",\n      \"rank\": 0,\n      \"balance_free\": \"341685\",\n      \"balance_staked\": \"411143703593\",\n      \"balance_staked_alpha_as_tao\": \"0\",\n      \"balance_staked_root\": \"0\",\n      \"balance_total\": \"411144045278\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4871820,\n      \"timestamp\": \"2025-02-06T23:59:48Z\",\n      \"rank\": 0,\n      \"balance_free\": \"341685\",\n      \"balance_staked\": \"410946690303\",\n      \"balance_staked_alpha_as_tao\": \"0\",\n      \"balance_staked_root\": \"0\",\n      \"balance_total\": \"410947031988\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4864621,\n      \"timestamp\": \"2025-02-05T23:59:48Z\",\n      \"rank\": 0,\n      \"balance_free\": \"341685\",\n      \"balance_staked\": \"410750555856\",\n      \"balance_staked_alpha_as_tao\": \"0\",\n      \"balance_staked_root\": \"0\",\n      \"balance_total\": \"410750897541\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4857421,\n      \"timestamp\": \"2025-02-04T23:59:48Z\",\n      \"rank\": 0,\n      \"balance_free\": \"341685\",\n      \"balance_staked\": \"410554552430\",\n      \"balance_staked_alpha_as_tao\": \"0\",\n      \"balance_staked_root\": \"0\",\n      \"balance_total\": \"410554894115\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4850221,\n      \"timestamp\": \"2025-02-03T23:59:48Z\",\n      \"rank\": 0,\n      \"balance_free\": \"341685\",\n      \"balance_staked\": \"410358936690\",\n      \"balance_staked_alpha_as_tao\": \"0\",\n      \"balance_staked_root\": \"0\",\n      \"balance_total\": \"410359278375\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4843021,\n      \"timestamp\": \"2025-02-02T23:59:48Z\",\n      \"rank\": 0,\n      \"balance_free\": \"341685\",\n      \"balance_staked\": \"410170603370\",\n      \"balance_staked_alpha_as_tao\": \"0\",\n      \"balance_staked_root\": \"0\",\n      \"balance_total\": \"410170945055\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4835821,\n      \"timestamp\": \"2025-02-01T23:59:48.001Z\",\n      \"rank\": 0,\n      \"balance_free\": \"341685\",\n      \"balance_staked\": \"409982965216\",\n      \"balance_staked_alpha_as_tao\": \"0\",\n      \"balance_staked_root\": \"0\",\n      \"balance_total\": \"409983306901\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4828622,\n      \"timestamp\": \"2025-01-31T23:59:48.001Z\",\n      \"rank\": 0,\n      \"balance_free\": \"341685\",\n      \"balance_staked\": \"409795617749\",\n      \"balance_staked_alpha_as_tao\": \"0\",\n      \"balance_staked_root\": \"0\",\n      \"balance_total\": \"409795959434\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4821422,\n      \"timestamp\": \"2025-01-30T23:59:48Z\",\n      \"rank\": 0,\n      \"balance_free\": \"341685\",\n      \"balance_staked\": \"409613370493\",\n      \"balance_staked_alpha_as_tao\": \"0\",\n      \"balance_staked_root\": \"0\",\n      \"balance_total\": \"409613712178\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4814222,\n      \"timestamp\": \"2025-01-29T23:59:48.001Z\",\n      \"rank\": 0,\n      \"balance_free\": \"341685\",\n      \"balance_staked\": \"409436660235\",\n      \"balance_staked_alpha_as_tao\": \"0\",\n      \"balance_staked_root\": \"0\",\n      \"balance_total\": \"409437001920\",\n      \"created_on_date\": \"2023-03-21\",\n      \"created_on_network\": \"finney\",\n      \"coldkey_swap\": null\n    },\n    {\n      \"address\": {\n        \"ss58\": \"5HGtyz1mAgRMPgtubVTaJv8VBfwJ7a5KGGGDw5PX7WPPwLKS\",\n        \"hex\": \"0xe67990e42259688c76faad3d2cb02dbba69ecef0c780356181eac0512de6d752\"\n      },\n      \"network\": \"finney\",\n      \"block_number\": 4807022,\n      \"timestamp\": \"2025-01-28T23:59:48Z\",\n      \"rank\": 0,\n      \"balance_free\": \"341685\",\n      \"balance_staked\": \"409253019220\",\n      \"balance_staked_alpha_as_tao\": \"0\",\n      \"balance_staked_root\": \"0\",\n      \"balance_total\": \"409253360905\",\n      \"created_on_date\": \"


/* … truncated, full schema in /api/openapi.json */

400 — Bad request

Section titled “400 — Bad request”

404 — Account history not found

Section titled “404 — Account history not found”

500 — Internal server error

Section titled “500 — Internal server error”

Try it

Section titled “Try it”

Interactive request console coming soon. In the meantime you can use the OpenAPI spec with any client (Insomnia, Bruno, Scalar, curl).

Authentication

Section titled “Authentication”

All Taostats API requests require an Authorization header containing your API key. See Getting Started.