Wallet report

Wallet reports list booked movements, wallet fees and running balances for one Stablecoins wallet.

Request a wallet report

Create wallet report

Setting	Value
Production URL	`https://stablecoins.volt.io`
Sandbox URL	`https://stablecoins.sandbox.volt.io`
Authentication	Customer API token and `X-Volt-Api-Version: 1`
`walletId`	Path parameter: ID of one of your wallets
`startDate`	Inclusive start, ISO 8601 with an offset, treated in UTC
`endDate`	Exclusive end, at least one hour in the past and at most 92 days after the start

POST https://stablecoins.volt.io/reports/wallet/{walletId}
Authorization: Bearer YOUR_ACCESS_TOKEN
X-Volt-Api-Version: 1
Content-Type: application/json

{
  "startDate": "2026-08-01T00:00:00Z",
  "endDate": "2026-09-01T00:00:00Z"
}

Use midnight UTC on both ends for calendar periods. Request yesterday's report from 01

UTC onwards.

Up to 100,000 booked entries per report.

At most 3 reports generating per wallet; additional requests return 429.

Each request creates a new report; no idempotency key is required.

Check status and download

API Reference

Poll GET /reports/{id} on the same Stablecoins API host until REPORT_AVAILABLE; walletId, startDate and endDate identify the wallet and period.

Download with GET /reports/{id}/download; files are kept for 7 days after generation.

Download returns 404 for missing, unavailable or expired reports, or reports owned by another customer.

Request a new report after REPORT_FAILED or REPORT_EXPIRED.

List earlier reports with GET /reports?walletId=…&page=1&limit=50; results are oldest first, with pagination in response headers.

What's in the file

Column	Description	Always filled
`accountId`	Wallet ID.	Yes
`accountType`	`CRYPTO_WALLET` or `FIAT_PAYMENT_ACCOUNT`.	Yes
`accountLabel`	Wallet name.	No
`accountIdentifier`	Fiat IBAN or account number; empty for crypto wallets.	No
`customerId`	ID of the customer that owns the wallet.	Yes
`customerName`	Customer name.	No
`transactionId`	Movement ID, shared with its fee rows; empty on balance rows.	No
`transactionType`	`PAYIN`, `PAYOUT`, `REFUND`, `SETTLEMENT`, `INTERNAL_TRANSFER`, `FEE`, `REVERSAL`, `ADJUSTMENT`, `OPENING_BALANCE` or `CLOSING_BALANCE`.	Yes
`subType`	Movement category, such as `CHANNEL`, `PAYMENT_LINK`, `CRYPTO`, `BANK`, `TRANSFER`, `CONVERSION`, `NETWORK_FEE`, `DEPOSIT_FEE` or `PROCESSING_FEE`.	No
`transactionStatus`	`COMPLETED` or `PENDING`; empty on balance rows. Payouts may be booked before completion. Failed payouts return funds as a `REVERSAL`.	No
`createdAt`	Movement creation time; detection time for channel deposits. Period boundary on balance rows.	Yes
`updatedAt`	Latest known completion or update time; confirmation time for channel deposits. Period boundary on balance rows.	Yes
`bookedAt`	Booking time. Selects entries into the period and determines row order. Period boundary on balance rows.	Yes
`paymentId`	Original payment ID for a refund.	No
`counterpartyAccountId`	Other wallet ID for an internal transfer or conversion. Both wallet reports share the movement ID.	No
`paymentReference`	Business reference: deposit end-user reference, payout, transfer, refund or settlement reference, or Checkout payment ID.	No
`internalReference`	Your reference supplied with a payout or transfer.	No
`amountCredit`	Amount credited in `currency`; empty on debit and balance rows.	No
`amountDebit`	Amount debited in `currency`; empty on credit and balance rows.	No
`currency`	Wallet-side currency.	Yes
`balanceAfter`	Balance after the row: previous balance + `amountCredit` − `amountDebit`. Opening/closing rows show the balance at each period boundary; a period without entries has equal balances.	Yes
`paidAmount`	Amount sent on chain for a pay-in or payout.	No
`paidCurrency`	Currency of `paidAmount`.	No
`exchangeRateBase`	Base currency of the applied exchange rate.	No
`exchangeRateCounter`	Counter currency of the applied exchange rate.	No
`exchangeRate`	Applied exchange rate.	No
`network`	Blockchain network, for example `ETHEREUM`.	No
`txHash`	On-chain transaction hash.	No
`blockchainAddress`	Receiving address for a deposit or destination address for a payout.	No
`sourceAddress`	Sending address of an incoming on-chain payment.	No
`channelId`	Channel ID for a channel deposit.	No
`beneficiaryName`	Payout or settlement beneficiary name.	No
`beneficiaryIban`	Beneficiary IBAN.	No
`beneficiaryAccountNumber`	Beneficiary account number.	No
`riskLevel`	Channel deposit risk: `LOW`, `MEDIUM`, `HIGH`, `SEVERE` or `UNKNOWN`.	No

CSV format

UTF-8, no byte-order mark, \n line endings; 35 columns.

Decimal amounts in major currency units; UTC timestamps as YYYY-MM-DDTHH:MM:SSZ.

Empty fields for unavailable values; spreadsheet formula prefixes are escaped with '.

Wallet report

Request a wallet reportCopy Anchor Link

Create wallet report

Check status and downloadCopy Anchor Link

Get report by ID

Download report

Get list of reports

What's in the fileCopy Anchor Link

CSV formatCopy Anchor Link

On this page

Request a wallet report

Check status and download

What's in the file

CSV format