---
title: "Get historical usage stats for a wallet address."
method: GET
path: "/v1/usage/history/stats"
tags: ["Billing"]
---

# Get historical usage stats for a wallet address.

`GET /v1/usage/history/stats`

## Query parameters

- `address` string, required — The wallet address to get billing and usage data for
- `startDate` string, date — Start date (YYYY-MM-DD). Defaults to 30 days before endDate
- `endDate` string, date — End date (YYYY-MM-DD). Defaults to today by UTC 23:59:59

## Response `200`

Returns usage stats data

- object
  - `totalSpent` number, required — Total amount spent in USD
  - `averageSpentPerDay` number, required — Average spending per day in USD
  - `totalDeployments` number, required — Total number of deployments deployed
  - `averageDeploymentsPerDay` number, required — Average number of deployments deployed per day

## Other responses

- `400` — Invalid address format

## Changes

- **2026-08-11** `ae76edbfc7f2` — 1 breaking
  - for the `query` request parameter `endDate`, default value `2026-07-20` was removed
- **2026-07-20** `c3b0e234fc13` — 1 breaking
  - for the `query` request parameter `endDate`, default value was changed from `2026-06-26` to `2026-07-20`
- **2026-06-26** `be2e5614d754` — 1 breaking
  - for the `query` request parameter `endDate`, default value was changed from `2026-06-17` to `2026-06-26`
- **2026-06-17** `b1975c50c4ba` — 1 breaking
  - for the `query` request parameter `endDate`, default value was changed from `2026-05-20` to `2026-06-17`
- **2026-05-20** `1f950a9aba80` — 1 breaking
  - for the `query` request parameter `endDate`, default value was changed from `2026-05-14` to `2026-05-20`

[Full history](https://skmtc.dev/akash-network/apis/akash-network-console-api/changes/v1/usage/history/stats/get.md)

---

[API](https://skmtc.dev/akash-network/apis/akash-network-console-api.md) · [All operations](https://skmtc.dev/akash-network/apis/akash-network-console-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/akash-network/akash-network-console-api/revisions/8c068a3af6fe/schema)