Net Settlement

Net Settlement reports apply exclusively to clients who are using their own fiat onramp solutions independently. For these clients, Bakkt provides two daily settlement reports to facilitate accurate reconciliation and settlement of transactions.


Daily Net Settlement Reports

Each day, Bakkt generates two critical files for the period from 9 AM CT of the previous day to 9 AM CT of the current day. At the top of both files, there will be a summary that indicates the beginning and ending times for the transactions included in the net settlement along with the net money that needs to be settled between Bakkt and the client who is using Bakkt execution services for daily settlements.  Read about both reports below:

  • Settlement Detail File: This file contains detailed transaction data for all crypto executions within the day's specified timeframe. It confirms that all listed coin executions have been cleared, with the assets now reflecting in the customer's holdings. This document is vital for cross-verifying transaction reconciliation between your system and Bakkt
  • Settlement Summary Report: This file presents an aggregated view of executions by cryptocurrency type and outlines the net money required for settlement between the client and Bakkt. It serves as a concise overview for financial reconciliation and settlement processes.

Each day, your team will net settle funds using a wire transfer. The settlement summary file will be emailed to your finance team and the Bakkt Operations team to facilitate the daily net settlement process. We request you to provide an appropriate email distribution list to ensure the right team members are looped into these communications. Any discrepancies identified will be collaboratively resolved by our teams before finalizing the settlement.


Start-of-Day Settlement Report Data Layout

The two settlement files will be uploaded to the eod_settlement directory in your S3 bucket.

The file name convention is as follows: 

  • YYYY-MM-DDsettlement_summary
  • YYYY-MM-DDsettlement_detail
Settlement Summary FieldsDefinitions
FromBeginning time stamp of the settlement window.
ToEnd time stamp of the settlement window
Net SettlementUSD value of what is owed after the 9 AM cutoff. Positive values mean the client owes Bakkt. Negative values mean Bakkt owes the client.
coinEach coin traded is listed in this column. First row is an aggregated view of all trades denoted by “all”.
firm notionalUSD value of all trades in a window.
firm qtyToken quantity traded in the window.
Settlement Detail FieldsDefinitions
FromBeginning time stamp of the settlement window.
ToEnd time stamp of the settlement window.
Net SettlementUSD value of what is owed after the 9 AM cutoff. Positive values mean the client owes Bakkr. Negative values mean Bakkt owes the client.
Account IDClient’s  unique Account ID for the customer’s account.
Client Order IDOrder ID sent with crypto order.
Execution IDUnique identifier sent in execution report. Execution IDs are often numbers, but can also be alpha-numeric.
Trade DateDate part of the Execution Timestamp.
Execution TimeUTC time of execution/fill.
SideText string with Buy or Sell for trades and DEPOSIT and WITHDRAWAL  for manual adjustments.
SymbolCrypto symbol for trade (i.e. BTC).
Last QuantityQuantity filled for corresponding Execution ID.
Last PricePrice where execution was filled.
NotionalNotional Value of the fill (i.e. Last Price * Last Quantity).
FeesTrade fee in USD, where applicable.
TotalTotal cost of the execution (Notional + Fees).

Reconciliation of Crypto Trade executions

Like an equity trade reconciliation, you can use the settlement detail file to reconcile all the customer trade executions you have in your system vs. the executions that Bakkt knows have happened.


Net Settlement Example Reports

Settlement Detail Example

Period Covered: December 12, 2022, 14:00 UTC to December 13, 2022, 14:00 UTC

From: 2022-12-12T14:00:00Z

To: 2022-12-13T14:00:00Z

Net Settlement Amount: $19.00

Account IDClient Order IDExecution IDTrade DateExecution TimeSideSymbolLast QuantityLast PriceNotionalFeesTotal
xyz123jlp3821ad5a-2bf6-406b-aba4-a1d3c79dfd46e5a318e0627845df88465f7097aeab7a12/12/20222022-12-12T21:33:17ZBUYDOGE43.975078880.09096061404
xyz224jlp6107b579-d613-4b55-97ec-e2b9321a69bf2022346-APEX-1-573-1107512/12/20222022-12-12T21:32:44ZBUYBTC0.0002879717362.66666667505
xyz444klmfce6b985-85d3-4ab6-8cdd-d762f840185bpeak6-wmtord-LJAHACDBNCGLABMEAGAAMBAA-LA12/12/20222022-12-12T21:29:50ZBUYATOM0.514822669.71208222505
xyz444klmf498b1de-c7a8-4c50-9b9a-63658ce49bff2022346-APEX-1-573-1103512/12/20222022-12-12T21:29:08ZBUYBTC0.0002879317365.404040450

Note: A positive net settlement figure indicates an outstanding balance owed to Bakkt by the client.

Settlement Summary Example

Period Covered: December 12, 2022, 14:00 UTC to December 13, 2022, 14:00 UTC

From: 2022-12-12T14:00:00Z

To: 2022-12-13T14:00:00Z

Net Settlement Amount: $19.00

coinfirm notionalfirm qtyallocation qtydiff qty
all19.0044.49047744044.49047744
ATOM5.000.5148226600.51482266
BTC10.000.000575900.0005759
DOGE4.0043.97507888043.97507888

Note: A positive net settlement figure indicates an outstanding balance owed to Bakkt by the client.