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

# Mood Statistics

> Get mood statistics for the current user

<Note>This endpoint requires authentication.</Note>

## Query Parameters

<ParamField query="days" type="integer" default="30">
  Number of days to analyze (max 365)
</ParamField>

## Response

<ResponseField name="averageMood" type="number">
  Average mood score over the period
</ResponseField>

<ResponseField name="totalEntries" type="integer">
  Number of mood entries in the period
</ResponseField>

<ResponseField name="moodTrend" type="string">
  Trend direction: `improving`, `stable`, or `declining`
</ResponseField>

<ResponseField name="distribution" type="object">
  Count of entries per mood value
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.hitler.app/api/moods/stats?days=30" \
    -H "Authorization: Bearer YOUR_TOKEN"
  ```

  ```typescript TypeScript theme={null}
  const stats = await api.getMoodStats({ days: 30 });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "averageMood": 3.7,
    "totalEntries": 22,
    "moodTrend": "improving",
    "distribution": {
      "1": 0,
      "2": 2,
      "3": 8,
      "4": 10,
      "5": 2
    }
  }
  ```
</ResponseExample>