TillsafeDocstillsafe.comRequest early access

Reconciliation

The ledger vs the chain vs the invoices for a period, with every difference explained or flagged

GET /v1/reconciliation

Reconcile a period.

For the invoices created in [from, to) (and the unattributed deposits opened in it), compares three views of the same money per asset: the ledger entries posted for them, the on-chain transfers, and the invoices' outcomes. Every difference is listed as a discrepancy, either explained (expected: still confirming, held for review, refund owed, ...) or flagged (someone should look). Defaults to the last 30 days; at most 366 days.

Authentication: Secret key

Parameters

ParameterInTypeDescription
fromquerystring

Start (inclusive): 2026-09-01 (midnight UTC) or RFC 3339. Default: 30 days before to

toquerystring

End (exclusive). Default: now

assetquerystring

Only this asset, e.g. USDT@tron:nile

Responses

StatusDescriptionBody
200
Reconciliation application/json
400
ErrorResponse application/json

GET /v1/reconciliation/balances

Ledger balances as of a date.

For each asset and account group of your ledger: the balance at from, the postings in [from, to), the balance at to (the balance as of to), and the previous period's movement (the equally long period ending at from), so a month can be compared with the last. Unlike the reconciliation report, every journal entry counts by its own date. Defaults to the last 30 days; at most 366 days.

Authentication: Secret key

Parameters

ParameterInTypeDescription
fromquerystring

Start (inclusive): 2026-09-01 (midnight UTC) or RFC 3339. Default: 30 days before to

toquerystring

End (exclusive): the balances are as of this moment. Default: now

assetquerystring

Only this asset, e.g. USDT@tron:nile

Responses

StatusDescriptionBody
200
LedgerBalances application/json
400
ErrorResponse application/json

GET /v1/reconciliation/export

Export a reconciliation as CSV.

The same report as GET /v1/reconciliation, one row per figure and per discrepancy. Columns: section,asset,item,amount,severity,invoice,network,tx_hash,index,detail. Amounts are decimal strings; text that a spreadsheet would run as a formula is prefixed with '.

Authentication: Secret key

Parameters

ParameterInTypeDescription
fromquerystring

Start (inclusive), as for the report

toquerystring

End (exclusive), as for the report

assetquerystring

Only this asset

Responses

StatusDescriptionBody
200

CSV (RFC 4180, CRLF line ends)

string text/csv
400
ErrorResponse application/json