Generates a report. You can create reports with historical data for all report types. Balance reports can be snapshots of historical or current data.
Reports provide batches of historic information about your profile in various human and machine readable forms.
A report is generated when resources are available. You can poll the report resource endpoint at /reports/{report_id}
for its status. When status is ready
, the final report is uploaded and available at {file_url}
.
This endpoint requires either the “view” or “trade” permission.
Reports are only available for download for a few days after being created. Once a report expires, the report is no longer available for download and is deleted.
Balance statements represent historical or current point-in-time “snapshots” in native and fiat converted units. Balance statement reports:
Can be generated for a specific portfolio (API and UI) or all portfolios (UI only). In the UI, all portfolios can be grouped by portfolio or asset (with balances totaled across portfolios).
Include balances for crypto and fiat assets supported on the Exchange (USD, EUR, GBP).
Include balances in both native units (e.g., 1 BTC) as well as fiat-converted units assets (e.g., $20000 USD worth of BTC) where price data is available.
Are generated for all assets (crypto and fiat) in the user’s account as of the requested timestamp. They cannot be generated for a specific asset (as is possible with the account and fill reports).
API calls are tied to a specific portfolio but you can group by all portfolios in the UI.
Range: Timestamps are UTC-exclusive. For example, to generate a balance as of December 31st, 2022 EOD UTC (11:59:59 PM UTC), input January 1st, 2023 12:00:00 AM UTC.
Granularity: The API is the most granular and lets you specify a timestamp to the very second. The UI lets you specify the day and hour.
For fiat balances (USD, EUR, GBP), the conversion price is 1:1 and is reported in that specific fiat currency. EUR/GBP is not converted to USD balance.
For crypto balances the conversion price is the volume weighted average of closing prices in USD (when available). It is calculated by fetching 1 hour candles between [t-24 hours to t] and taking a volume weighted average of the closing price of the candles (when available).
The Balance Report API:
/reports
endpoint.balance
.balance
object to the request with datetime
(and group_by_portfolio_id
for the UI only)."type"="balance"
).Example of Balance Report API Request
The response is of type object
.