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

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# API Stats

> Listez les métriques proposées par l'API Stats et interrogez les métriques d'un compte dans le temps, avec des filtres et des ventilations.

Utilisez l'API Stats pour découvrir les métriques disponibles, puis récupérer une série temporelle pour un compte. La [référence Stats](https://docs.whop.com/fr/api-reference/stats/stats) explique chaque métrique, ses unités et les filtres pris en charge.

> [!NOTE]
>
> Les requêtes sur le chiffre d'affaires d'un compte nécessitent la permission `stats:read`. Consultez
> [Permissions](https://docs.whop.com/fr/developer/guides/permissions.md) pour demander des permissions pour votre application.

## Découvrir les métriques

[Listez les métriques de séries temporelles](https://docs.whop.com/fr/api-reference/stats/list-time-series-metrics.md) pour obtenir leurs clés, noms, unités, descriptions et propriétés filtrables :

```bash theme={null}
curl "https://api.whop.com/api/v1/stats/time_series" \
  -H "Authorization: Bearer $WHOP_API_KEY"
```

Utilisez la `key` d'une métrique, comme `gross_revenue`, dans la requête suivante. Son tableau `properties` liste les propriétés selon lesquelles vous pouvez filtrer ou ventiler.

## Récupérer une série temporelle

Transmettez l'ID de votre compte et une plage de dates à [Retrieve metric time series](https://docs.whop.com/fr/api-reference/stats/retrieve-metric-time-series.md) :

```bash theme={null}
curl --get "https://api.whop.com/api/v1/stats/time_series/gross_revenue" \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  --data-urlencode "account_id=YOUR_ACCOUNT_ID" \
  --data-urlencode "from=2026-08-01" \
  --data-urlencode "to=2026-08-31" \
  --data-urlencode "interval=day" \
  --data-urlencode "convert_to=usd"
```

Le tableau `data.points` de la réponse contient un `timestamp` Unix en secondes et une `value` pour chaque période. Lisez la valeur dans l'unité du catalogue : `count` est un nombre, `currency` un montant décimal, et `percent` est déjà exprimé en points de pourcentage (`1.6` signifie 1,6 %).

Certaines métriques renvoient aussi `data.totals` pour toute la plage. Utilisez ces totaux lorsqu'ils sont fournis : faire la moyenne de taux journaliers ou additionner des nombres journaliers de valeurs uniques ne donne pas le résultat sur toute la plage.

## Filtrer et ventiler les résultats

Transmettez directement une propriété en paramètre de requête pour filtrer selon celle-ci. Utilisez `breakdown_by` pour scinder chaque point selon une propriété. Cet exemple filtre le chiffre d'affaires brut sur les paiements par carte et le ventile selon la devise d'origine de la transaction :

```bash theme={null}
curl --get "https://api.whop.com/api/v1/stats/time_series/gross_revenue" \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  --data-urlencode "account_id=YOUR_ACCOUNT_ID" \
  --data-urlencode "from=2026-08-01" \
  --data-urlencode "to=2026-08-31" \
  --data-urlencode "payment_method=card" \
  --data-urlencode "breakdown_by=currency"
```

Chaque point inclut un tableau `breakdown` d'entrées `{ name, value }`. Filtrer ou ventiler les métriques de transaction par `currency` renvoie les montants dans leur devise d'origine, sans conversion.

N'utilisez que les propriétés listées pour la métrique. Une propriété non prise en charge renvoie `400`. Une clé de métrique inconnue renvoie `404`. Consultez les [paramètres de requête](https://docs.whop.com/fr/api-reference/stats/stats#query-parameters) et la [référence des métriques](https://docs.whop.com/fr/api-reference/stats/retrieve-metric-time-series.md) pour les fuseaux horaires, les intervalles, les fenêtres d'instantané et les options propres à chaque métrique.


## Related topics

- [Référence de l'API Stats](https://docs.whop.com/fr/api-reference/stats/stats.md)
- [API Permissions](https://docs.whop.com/fr/api-reference/permissions/permission.md)
- [Versions de l'API](https://docs.whop.com/fr/developer/api/versioning.md)
