> ## 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.

# Stats API

> Vis de metrikker, Stats API tilbyder, og forespørg en kontos metrikker over tid med filtre og opdelinger.

Brug Stats API til at finde tilgængelige metrikker, og hent derefter en tidsserie for en konto. [Stats-referencen](https://docs.whop.com/da/api-reference/stats/stats) forklarer hver metrik, dens enheder og understøttede filtre.

> [!NOTE]
>
> Forespørgsler på kontoomsætning kræver tilladelsen `stats:read`. Se
> [Tilladelser](https://docs.whop.com/da/developer/guides/permissions.md) for at anmode om tilladelser til din app.

## Find metrikker

[Vis tidsseriemetrikker](https://docs.whop.com/da/api-reference/stats/list-time-series-metrics.md) for at få deres nøgler, navne, enheder, beskrivelser og filtrerbare egenskaber:

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

Brug en metriks `key`, f.eks. `gross_revenue`, i den næste request. Dens `properties`-array viser de egenskaber, du kan filtrere eller opdele efter.

## Hent en tidsserie

Send dit konto-ID og et datointerval til [Retrieve metric time series](https://docs.whop.com/da/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"
```

Svarets `data.points`-array indeholder et Unix-`timestamp` i sekunder og en `value` for hver periode. Læs værdien i katalogets enhed: `count` er et antal, `currency` er et decimalbeløb, og `percent` er allerede i procentpoint (`1.6` betyder 1,6 %).

Nogle metrikker returnerer også `data.totals` for hele intervallet. Brug disse totaler, når de findes: et gennemsnit af daglige rater eller en sum af daglige unikke antal giver ikke resultatet for hele intervallet.

## Filtrer og opdel resultater

Send en egenskab direkte som query-parameter for at filtrere på den. Brug `breakdown_by` til at opdele hvert punkt efter én egenskab. Dette eksempel filtrerer bruttoomsætningen til kortbetalinger og opdeler den efter den oprindelige transaktionsvaluta:

```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"
```

Hvert punkt indeholder et `breakdown`-array med `{ name, value }`-poster. Filtrering eller opdeling af transaktionsmetrikker efter `currency` rapporterer de oprindelige valutabeløb uden omregning.

Brug kun egenskaber, der er angivet for metrikken. En ikke-understøttet egenskab returnerer `400`. En ukendt metriknøgle returnerer `404`. Se [query-parametrene](https://docs.whop.com/da/api-reference/stats/stats#query-parameters) og [metrikreferencen](https://docs.whop.com/da/api-reference/stats/retrieve-metric-time-series.md) for tidszoner, intervaller, snapshotvinduer og metrikspecifikke indstillinger.


## Related topics

- [Stats API-reference](https://docs.whop.com/da/api-reference/stats/stats.md)
- [API-versioner](https://docs.whop.com/da/developer/api/versioning.md)
- [API-stabilitet](https://docs.whop.com/da/api-reference/stability.md)
