List billing cycles
View all billing charges for your organization.
Since August 2026, each row is one CALENDAR-MONTH charge for one user (billingMonth = first day of the month it covers, full month, no proration). A charge is created when:
- The trader’s first account is created (trigger:
account_created) - The monthly sweep bills a trader who still holds in_progress accounts at the start of a new month, or an account creation is their first billing trigger of the month (trigger:
auto_renewal)
Rows with billingMonth: null are historical 30-day cycles from before August 2026 — the old rolling model. They count toward the month they started in.
Statuses:
| Status | Meaning |
|---|---|
active | Covers the current period (expiresAt in the future) |
expired | Period ended |
cancelled | Manually cancelled |
Billing: Each row is an invoice line item. The price is locked in at creation — if your rate changes, only new months use the new rate.
Price breakdown: every row also carries platformPrice (the Hyperprop platform fee) and marketDataPrice (the CME Group market data bundle — CME, CBOT, NYMEX, COMEX, always billed as one bundle). platformPrice + marketDataPrice = price always holds, including for historical rows from earlier pricing eras.
Same user, multiple rows: each billed month is a separate row — a complete billing history per trader.
Authorizations
JWT Bearer token for user session auth. Format: "Bearer {token}". Used by User and Organization endpoints.
Query Parameters
Filter by cycle status
active, expired, cancelled Results per page
1 <= x <= 100Pagination offset
x >= 0Related topics
List all billing eventsGet events for a billing cycleGet all-months billing aggregatesList roles (system presets + your custom roles)Get daily billing activity