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

# Get Metrics

> Retrieve usage metrics and transaction statistics

### Authorization

<ParamField header="Authorization" type="string" required>
  Bearer token. Format: `Bearer bookie_live_abc123def456`
</ParamField>

### Query Parameters

<ParamField query="startDate" type="string" required>
  Start date in ISO 8601 format
</ParamField>

<ParamField query="endDate" type="string" required>
  End date in ISO 8601 format
</ParamField>

<ParamField query="granularity" type="string" default="day">
  Data granularity. Options: `hour`, `day`, `week`, `month`
</ParamField>

### Response

<ResponseField name="period" type="object">
  Time period for metrics
</ResponseField>

<ResponseField name="transactions" type="object">
  Transaction statistics

  Properties:

  * `total` (number): Total transactions
  * `swaps` (number): Token swap transactions
  * `transfers` (number): Transfer transactions
  * `successRate` (number): Success rate percentage
</ResponseField>

<ResponseField name="volume" type="object">
  Trading volume statistics

  Properties:

  * `totalUSD` (number): Total volume in USD
  * `averagePerTransaction` (number): Average transaction size
</ResponseField>

<ResponseField name="intents" type="object">
  Intent parsing statistics

  Properties:

  * `total` (number): Total intents parsed
  * `averageConfidence` (number): Average confidence score
  * `parseErrors` (number): Failed parses
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.bookie.app/v1/analytics/metrics?startDate=2024-03-01T00:00:00Z&endDate=2024-03-08T23:59:59Z' \
    --header 'Authorization: Bearer bookie_live_abc123def456'
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    'https://api.bookie.app/v1/analytics/metrics?startDate=2024-03-01T00:00:00Z&endDate=2024-03-08T23:59:59Z',
    {
      headers: {
        'Authorization': `Bearer ${process.env.BOOKIE_API_KEY}`
      }
    }
  );
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.bookie.app/v1/analytics/metrics',
      headers={
          'Authorization': f'Bearer {api_key}'
      },
      params={
          'startDate': '2024-03-01T00:00:00Z',
          'endDate': '2024-03-08T23:59:59Z'
      }
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "period": {
      "start": "2024-03-01T00:00:00Z",
      "end": "2024-03-08T23:59:59Z",
      "granularity": "day"
    },
    "transactions": {
      "total": 1847,
      "swaps": 1523,
      "transfers": 324,
      "successRate": 98.7
    },
    "volume": {
      "totalUSD": 2847392.47,
      "averagePerTransaction": 1541.23
    },
    "intents": {
      "total": 2103,
      "averageConfidence": 0.96,
      "parseErrors": 47
    }
  }
  ```
</ResponseExample>