Get Balance History
Testing Env
http://k8s-partnera-partnera-7873f15634-69ebb7c047cac3d1.elb.eu-central-1.amazonaws.com
Testing Env
http://k8s-partnera-partnera-7873f15634-69ebb7c047cac3d1.elb.eu-central-1.amazonaws.com
GET
/v1/partner/balance-history/{balanceId}
balanceId (the id returned by Get Balances). An exchange appears in the history of both balances involved (source and destination), with the same externalId. Exchanges made in the web interface may involve self-custody balances, which are not returned by Get Balances. Such exchanges appear in the history with the sourceBalanceId or destinationBalanceId of the self-custody balance.Transaction types
type field. The set of fields depends on the type and on whether the balance is crypto or fiat:type | Balance | Specific fields |
|---|---|---|
WITHDRAWAL | crypto | toAddress, network, transactionHash |
WITHDRAWAL | fiat (SEPA) | accountHolder, iban, swift, bankName |
DEPOSIT | crypto | fromAddress, network, transactionHash |
DEPOSIT | fiat (SEPA) | senderName, senderIban, title |
EXCHANGE | any | sourceBalanceId, destinationBalanceId, sourceAmount, destinationAmount, rate, totalDestinationAmount |
Amounts and fees
totalAmount; the recipient receives amount; totalAmount = amount + fee.totalAmount.sourceAmount; the destination balance is credited with destinationAmount; destinationAmount = totalDestinationAmount - fee. The fee is charged in the destination currency. Amounts are rounded down to the precision of the currency.Pagination
hasMore is true, request the next page by passing the values from nextCursor as query parameters with the same names: cursorId and cursorCreatedAt. Pass the values exactly as received (URL-encoded). When hasMore is false, nextCursor is null.Request
Path Params
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'http://k8s-partnera-partnera-7873f15634-69ebb7c047cac3d1.elb.eu-central-1.amazonaws.com/v1/partner/balance-history/6f22378e-71e6-4389-b1d8-3e3d40828e28' \
--header 'x-api-key: <api-key>'Response Response Example
200 - Success - Crypto
{
"items": [
{
"type": "EXCHANGE",
"transactionId": null,
"externalId": "fef30922-04df-4b18-870b-6f67cc1b5842",
"sourceBalanceId": "6f22378e-71e6-4389-b1d8-3e3d40828e28",
"destinationBalanceId": "ea93abc7-389d-4bd6-aeff-2257bfa72683",
"status": "SUCCESSFUL",
"sourceAmount": "200",
"destinationAmount": "15.08",
"sourceCurrency": "DOGE",
"destinationCurrency": "EUR",
"rate": "0.08380226594362082",
"fee": "1.67",
"totalDestinationAmount": "16.75",
"createdAt": "2026-10-01T12:53:12.047Z",
"updatedAt": "2026-10-01T12:53:13.102Z"
},
{
"type": "WITHDRAWAL",
"transactionId": "4f70b4c9-9a38-4a52-ba16-4da3d50028af",
"externalId": "25b4f3a5-4881-4f39-b7db-18649641d92f",
"balanceId": "6f22378e-71e6-4389-b1d8-3e3d40828e28",
"status": "SUCCESSFUL",
"amount": "10",
"currency": "DOGE",
"toAddress": "DC8T55QR88dYbYKjzCBYic8QJ7nhiaJRkx",
"network": "DOGE",
"fee": "10",
"totalAmount": "20",
"transactionHash": "e8119744240b01a24adc41c83c46e760aadb3b324b203cfac5f69d16a4439e55",
"memo": null,
"walletId": "8cb28fd0-ba0e-445d-8851-13bf1fbfb11d",
"createdAt": "2026-09-28T09:12:20.136Z",
"updatedAt": "2026-09-28T09:15:02.106Z"
},
{
"type": "DEPOSIT",
"externalId": "1585c92f-1821-4cfe-b5d8-7e6a2e8ded12",
"balanceId": "6f22378e-71e6-4389-b1d8-3e3d40828e28",
"status": "SUCCESSFUL",
"amount": "4.695",
"currency": "DOGE",
"fromAddress": "DAnrCwjXLHiqU4SNx6MQ8bHABxZB6NasvQ",
"network": "DOGE",
"fee": "0",
"totalAmount": "4.695",
"transactionHash": "dce61b95b5b48d5d9166228ccfad123c6de25b47c608fb089f09e70e556abd0c",
"createdAt": "2026-09-23T12:03:25.041Z",
"updatedAt": "2026-09-23T12:10:05.412Z"
}
],
"nextCursor": {
"cursorId": "1585c92f-1821-4cfe-b5d8-7e6a2e8ded12",
"cursorCreatedAt": "2026-09-23T12:03:25.041Z"
},
"hasMore": true
}