Get Daily Activity

Return one page of referred-user activity for the authenticated affiliate. The API returns activity for the account that owns the key, under its affiliate plan eligible for this API.

Two ways to request activity (use one per request):

• Day — activity_date (YYYY-MM-DD). One page of enrolled referred users who had activity that UTC trade day and have not opted out, plus quiet users who enrolled that day and day-wide totals. Even a user who has never traded has an enrollment-day entry with enrolled_at and empty products. Set all_users=true to include all still-enrolled users enrolled by that day, regardless of trading. Opted-out users appear as existence stubs only with all_users=true; their individual activity is excluded from items and totals. Unenrolled users are omitted from items only; their activity stays in totals.
• History — iiban (one to ten full Kraken account identifiers, comma-delimited) with inclusive start_date and end_date. The same per-day entries for those people only. An opted-out user still enrolled by the end of the range returns one existence stub without activity_date. Day-wide fields (totals, active_users, revision, estimated, opted_out) are omitted. Figures are never summed across days.

Sending both variants is a 400. Dates must be today or one of the previous 89 UTC days. A future date or a date older than that window is a 400. An in-window day with no activity or matching enrollments returns an empty page.

Monetary figures are decimal strings in the top-level currency (always USD today): the reporting currency, not the payout asset. volume is omitted on fee-only products (margin_rollover). maker and taker appear only on execution products (spot, margin, futures, tokenized spot). Instant buy/sell (ptl_trading, tokenized_equity_ptl_trading) and financing charges have no liquidity side. Absence of maker/taker means unclassified, not zero. When both are present they cover only the classified portion; the difference from the product total is unclassified activity.

The products map is open-ended: ignore unknown keys. An absent key on a visible entry means no reported activity for that product. On an opted-out stub, empty or omitted products means withheld data, not zero activity. Current keys: spot_trading, ptl_trading, margin_trading, margin_rollover, futures_order_fill, tokenized_equity_spot_trading, tokenized_equity_ptl_trading. Options is not included.

Day-wide totals include activity from referred users who have not opted out, including users omitted from items because they are not enrolled in your plan. Activity from people who opted out may appear under opted_out as summary; smaller groups are suppressed. Daily figures may differ from weekly payments: totals exclude activity that cannot earn commission, activity from blocked regions is shown separately, and this API groups by trade date while payments group by when activity was recorded.

Opted-out stubs retain referee_reference, hour-truncated enrolled_at, opted_out=true, and the plan’s referral_code with empty products. They omit iiban, masked_iiban, and individual financial or plan-status details. Stub presence is independent of trading; do not interpret a stub as zero activity.

Use referee_reference to match a referred user across days. masked_iiban is the last four characters of the IIBAN and is not unique. Visible entries also include the full iiban, which you can use for history requests. enrolled_at is truncated to the hour.

revision (day variant, first page) is when this partner’s figures for that UTC day were last written. Enrollments and opt-out changes do not advance it; poll the roster even when revision is unchanged. Re-check the trailing 35 days for late events. estimated is true when amounts for that calendar day are still an estimate.

Examples use synthetic identifiers, not customer account data. Replace example dates with dates inside the current 90-day window. Empty collections and zero-valued fields may be omitted; treat missing items or products as empty.

Successful responses are the object itself. Errors are a non-2xx status with a typed error body, not a wrapped { "error", "result" }.

API Key Permissions Required: select the Query affiliate participants checkbox.