---
title: "Get aggregate account volume over a date range"
method: GET
path: "/api/v1/account_volume"
tags: ["Account"]
---

# Get aggregate account volume over a date range

`GET /api/v1/account_volume`

Returns the account's total, maker, and taker volume (in whole USD) for the requested
inclusive date range. When `start_date` and `end_date` are omitted the range defaults
to the past 30 days (today() - 29 .. today(), UTC).

Both `start_date` and `end_date` must be supplied together (YYYY-MM-DD format).
Volume data has up to 5-minute delay (MV refresh interval).

## Query parameters

- `account` string, required
- `start_date` string
- `end_date` string

## Response `200`

Account volume retrieved

- AccountVolumeDto — Response for `GET /api/v1/account_volume?account=<address>&start_date=<YYYY-MM-DD>&end_date=<YYYY-MM-DD>`. Returns the account's aggregate trading volume (total, maker, taker) in whole USD for the requested inclusive date range. When `start_date`/`end_date` are omitted the range defaults to the past 30 days (today() - 29 .. today() inclusive, UTC). Volume data has up to 5-minute delay (MV refresh interval).
  - `account` string, required — The queried account address
  - `end_date` string, required — Inclusive end date of the range used (YYYY-MM-DD, UTC)
  - `maker_volume` string, required — Maker-side volume across the range (USD, whole-dollar integer string)
  - `start_date` string, required — Inclusive start date of the range used (YYYY-MM-DD, UTC)
  - `taker_volume` string, required — Taker-side volume across the range (USD, whole-dollar integer string)
  - `volume` string, required — Total volume across the range (USD, whole-dollar integer string)

## Other responses

- `400` — Invalid account address or date parameters
- `500` — Database error

---

[API](https://skmtc.net/decibel/apis/decibel-trading-api.md) · [All operations](https://skmtc.net/decibel/apis/decibel-trading-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decibel/decibel-trading-api/revisions/37a02083ff59/schema)