---
title: "Get deposit statistics"
method: GET
path: "/deposits/stats"
tags: ["Utilities"]
---

# Get deposit statistics

`GET /deposits/stats`

## Request

- Base URL: `https://v1.orchestrator.rhinestone.dev/deposit-processor`
- URL: `https://v1.orchestrator.rhinestone.dev/deposit-processor/deposits/stats`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/rhinestonewtf/apis/deposit-service-api/docs/deposits/stats/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns completed deposit counts, unique depositors, and USD volume for the requested period.

## Query parameters

- `period` '24h' | '7d' | '30d', required: Rolling time window for aggregated stats

## Headers

- `x-api-key` string: API key for authentication

## Response `200`

Deposit statistics for the requested period

- DepositStatsResponse
  - `period` '24h' | '7d' | '30d', required: Rolling time window for aggregated stats
  - `totalDeposits` integer, required
  - `uniqueUsers` integer, required
  - `volumeUsd` string, required

## Other responses

- `400`: Invalid query or API key
- `401`: Missing or invalid API key
- `403`: API key lacks required deposits scope
- `503`: Tenant billing verification is temporarily unavailable; retry after 5 seconds.

## Changes

- **2026-11-06** `aa1767d704fa`: 4 info
  - the endpoint scheme security `internalProjectBearer` was added to the API
  - the endpoint scheme security `tenantApiKey` was added to the API
  - the `header` request parameter `x-api-key` became optional
  - added the non-success response with the status `503`
- **2026-09-17** `676300ac19ff`: 3 info
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `401` status
  - added the optional property `code` to the response with the `403` status
- **2026-09-11** `b49146029e5a`: 1 breaking, 1 warning
  - the `header` request parameter `x-api-key` became required
  - deleted the `header` request parameter `authorization`
- **2026-06-09** `d2b3d6caf10b`: 2 info
  - api tag `Utilities` added
  - api tag `Processing` removed
- **2026-05-28** `26fe44507260`: 4 info
  - added the new optional `header` request parameter `authorization`
  - the `header` request parameter `x-api-key` became optional
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`

[Operation history](https://skmtc.dev/rhinestonewtf/apis/deposit-service-api/changes/deposits/stats/get.md)

---

[API](https://skmtc.dev/rhinestonewtf/apis/deposit-service-api.md) - [All operations](https://skmtc.dev/rhinestonewtf/apis/deposit-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rhinestonewtf/apis/deposit-service-api/revisions/aa1767d704fa?raw)