Total donated
GET /v1/stats/total · Secret or public key · scope stats:read
The total donated for today, this week, month, year or all time. Donations from all connected sources are counted, including ones rejected by moderation, and converted to rubles.
Loading the reference…
Parameters, responses and fields as tables
Parameters
Section titled “Parameters”| Name | In | Type | Description |
|---|---|---|---|
period |
query | string, values: DAY, WEEK, MONTH, YEAR, ALL_TIME, default ALL_TIME |
DAY — today from 00:00, WEEK — this week from Monday, MONTH — this month, YEAR — this year, ALL_TIME — all time. Boundaries follow timeZone. ALL_TIME by default. |
timeZone |
query | string, default Europe/Moscow |
The time zone used for period boundaries, for example Asia/Novosibirsk. Europe/Moscow by default. |
Responses
Section titled “Responses”200— OK400— A parameter is invalid, or the key was sent in the request address:invalid_parameter,token_in_query401— The key is missing, unknown, deleted or expired:missing_token,invalid_token,token_expired403— Wrong kind of key, the key lacks thestats:readscope, or the public key came from an address that is not in its list:wrong_token_type,insufficient_scope,origin_not_allowed429— Rate limit exceeded:rate_limited500— The request failed on our side:internal_error503— The API is temporarily unavailable:service_unavailable
Example response
Section titled “Example response”{ "period": "DAY", "from": "2026-11-09T17:00:00Z", "to": "2026-11-10T17:00:00Z", "total": { "value": "18250.25", "currency": "RUB" }}Schemas
Section titled “Schemas”| Field | Type | Description |
|---|---|---|
period |
string, values: DAY, WEEK, MONTH, YEAR, ALL_TIME |
The period from the request. |
from |
string (date-time) | Start of the period. For ALL_TIME, 1970-01-01T00:00:00Z. |
to |
string (date-time) | Start of the next period; that moment itself is not included. For ALL_TIME, the moment of the response. |
total |
Money |
The total donated for the period, in rubles. |
| Field | Type | Description |
|---|---|---|
value |
string | Decimal amount with two fraction digits. |
currency |
string | ISO 4217 code. |