Get time series
Returns aggregated financial data over time from the Fragment ledger.
The wallet is resolved automatically from your API key’s auth context,
or pass account_id to query a sub-account.
Each row contains the total amount and line_count for that period.
Filter with reporting_category, grouping, or line_category to narrow results.
All three filters can be combined — they are applied in order:
reporting_category first, then grouping, then line_category.
Tip: Call the /describe endpoint first to get the full taxonomy of
allowed values with human-readable descriptions.
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.
company:balance:read permission. See Permissions.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Query a sub-account's wallet instead of the caller's own.
Pass a biz_ or user_ tag. The caller must have company:balance:read
permission on the target account.
"biz_abc123"
Start date in ISO 8601 format.
"2025-01-01"
End date in ISO 8601 format.
"2025-12-31"
Time bucket granularity.
day, week, month Filter to a predefined reporting category. Each category maps to a curated set of line categories.
Call /describe to see all reporting categories and which line categories each one includes.
Filter to specific groupings. Pass multiple values to include several
(e.g. grouping[]=payments&grouping[]=refunds).
Call /describe to see all groupings and which line categories belong to each.
Filter to specific transaction types. Pass multiple values to include several
(e.g. line_category[]=payment_gross&line_category[]=payment_refund).
When omitted, all categories are included.
Call /describe to see all line categories with descriptions.
Filter to only include rows denominated in this currency.
When omitted, rows for all currencies are returned and a currency field appears on each row.
"usd"
"eur"
"gbp"
Convert all amounts to this currency using historical exchange rates, collapsing
multi-currency rows into one row per period. Can be combined with currency to
first filter then convert.
"usd"
"eur"
IANA timezone for period boundaries.
"UTC"
"America/New_York"
"Europe/London"