> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.withpaygent.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.withpaygent.com/_mcp/server.

# Analytics

> Cost and revenue over time.

## `paygent analytics trends`

Cost and revenue bucketed over a range.

```bash
paygent analytics trends --duration week --granularity daily
```

| Flag                | Description                             |
| ------------------- | --------------------------------------- |
| `--duration <d>`    | `today`, `week`, `month`, or `quarter`. |
| `--granularity <g>` | `hourly`, `daily`, or `monthly`.        |
| `--agent <a>`       | Narrow to one agent.                    |
| `--customer <c>`    | Narrow to one customer.                 |

> **Info**
>
> This endpoint understands only whole ranges, so `--since` and `--until` are rejected rather than rounded. A range of `today` is always bucketed hourly.

## `paygent analytics revenue`

Revenue summary.

```bash
paygent analytics revenue --customer acme --i-understand-this-is-mock
```

> **Warning**
>
> This endpoint returns hard-coded placeholder data, not your revenue. The command refuses to run without the acknowledgement flag. Do not use its numbers.