> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usetapp.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Stats

> Aggregate order volume, count, and fee earnings over a period.

Returns settled-order aggregates for the authenticated sender.

### Header Parameters

<ParamField header="API-Key" type="string" required>
  Unique API key issued manually through Telegram.
</ParamField>

### Query Parameters

<ParamField query="period" type="string">
  Time window: `today`, `week`, `month`, or `all` (default). Anything else
  returns `400`.
</ParamField>

### Response

<ResponseField name="status" type="string">Response state (`success`).</ResponseField>

<ResponseField name="data" type="object">
  <ResponseField name="totalOrders" type="integer">Count of settled orders in the period.</ResponseField>
  <ResponseField name="totalOrderVolume" type="string">Summed order amount (token units).</ResponseField>
  <ResponseField name="totalFeeEarnings" type="string">Summed sender fee.</ResponseField>
</ResponseField>

<ResponseExample>
  ```json Response (200 OK) theme={null}
  {
    "status": "success",
    "message": "Sender stats retrieved successfully",
    "data": {
      "totalOrders": 128,
      "totalOrderVolume": "45230.50",
      "totalFeeEarnings": "226.15"
    }
  }
  ```
</ResponseExample>