Get Balance History
Testing Env
https://stage-api.fintegence.io
Testing Env
https://stage-api.fintegence.io
GET
/v1/partner/balance-history/{currency}
DOGE, EUR). Tracks financial flows, deposits, withdrawals, and exchange operations.withdrawals: outgoing transfers from the partner account (fiat or crypto).deposits: incoming transfers to the partner account.exchanges: currency exchange operations performed on the platform.Transaction Categories & Statuses
Withdrawals (withdrawals[])
| Status | Description |
|---|---|
started | Operation initiated |
pending | Queued for processing |
successful | Fully cleared and completed |
canceled | Operation canceled by user or system |
locked-to-processing | Internal lock applied for atomic settlement |
waiting-to-be-risk-checked | Pending clearance by risk management engine |
waiting-to-be-sent | Approved and queued for blockchain/network dispatch |
waiting-for-verification | Pending compliance or manual verification |
banned | Operation blocked due to policy or compliance violation |
questioned | Flagged for additional review |
rejected-by-reviewer | Declined after manual reviewer inspection |
Deposits (deposits[])
| Status | Description |
|---|---|
started | Incoming deposit detected |
pending | Awaiting sufficient confirmations or processing |
successful | Confirmed and credited to balance |
unsuccessful | Failed to complete settlement |
locked-to-processing | Internal processing lock |
waiting-for-verification | Awaiting compliance/AML check |
banned | Deposit blocked due to compliance restrictions |
rejected-by-reviewer | Rejected after compliance review |
Exchanges (exchanges[])
| Status | Description |
|---|---|
started | Conversion order created |
pending | Execution underway |
successful | Swap completed and balances updated |
unsuccessful | Conversion failed to execute |
locked-to-processing | Locked during execution phase |
waiting-for-verification | Pending compliance verification |
banned | Operation restricted |
rejected-by-reviewer | Rejected after manual review |
Request
Path Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://stage-api.fintegence.io/v1/partner/balance-history/' \
--header 'x-api-key: <api-key>'Response Response Example
200 - Success
{
"withdrawals": [
{
"transactionId": "67eef5f4-cd30-472f-9ee5-1b9d09fb746c",
"externalId": "7c74c68a-c4e8-4b1a-9bee-6347ae34f156",
"status": "successful",
"amount": "1",
"currency": "DOGE",
"destination": "0x045283b733522ED7A50C8849CfB2442057BC4697",
"network": null,
"fee": "2",
"transactionHash": "27ab93dc6023eed591b1d2b8f36308eff4a07eedd22c21bd578304f8d4ff0e72",
"createdAt": "2026-09-10T11:17:02.315Z"
}
],
"deposits": [
{
"externalId": "30e07f7a-1c05-4149-a2e2-3717da9d9490",
"status": "successful",
"amount": "1",
"currency": "DOGE",
"from": "0x5fa1f7c5205ee01030b73601bdec63f3e7e677fe",
"fee": "0",
"transactionHash": "0xcedfe0a8db658a000acefbbf5be27c7b0b91edd20caaa2657fdcfcf456446b77",
"createdAt": "2026-09-10T10:50:01.517Z"
}
],
"exchanges": [
{
"transactionId": "921a9579-f7d2-4c82-b470-ab6db7af1a32",
"externalId": "fab0db22-1e57-4e7c-8f9a-6b084a24b4c7",
"status": "pending",
"sourceAmount": "10",
"destinationAmount": "0.6056330404505998",
"sourceCurrency": "DOGE",
"destinationCurrency": "EUR",
"rate": "0.06056330404505999",
"fee": "10",
"createdAt": "2026-09-10T11:11:59.845Z"
}
]
}