Account
GET /api/v1/balances
Current balance for each currency the agency holds.
Returns the current balance for each currency the agency holds.
Permission: Read
Capture the id field from each balance row — you need it as the {balance_id} path parameter
to query that currency's financial history.
Sandbox: Returns empty data array and meta.financialOperationsEnabled: false.
Request example
curl --request GET \
--url https://api.fx-port.com/api/v1/balances \
--header 'Authorization: Bearer fxp_live_YOUR_KEY'Response example
An agency can hold multiple currency balances. Each row has its own id.
{
"environment": "live",
"success": true,
"data": [
{
"id": "db002f7a-c136-4f32-b19d-38a2542f2af9",
"agency_id": "2e800fb6-0bbf-4fc1-b0bd-0f3be3b5bcc4",
"currency_code": "EGP",
"available_balance": 412500.00,
"created_at": "2024-08-22T10:24:06.533800+00:00",
"updated_at": "2026-08-17T04:45:15.697817+00:00"
},
{
"id": "a71c9e34-2b18-40df-9c77-6b0a1f2e5d40",
"agency_id": "2e800fb6-0bbf-4fc1-b0bd-0f3be3b5bcc4",
"currency_code": "EUR",
"available_balance": 18750.50,
"created_at": "2024-08-22T10:24:06.533800+00:00",
"updated_at": "2026-08-16T22:10:03.120400+00:00"
},
{
"id": "c5f0a812-7d63-4e9a-8b21-4e9f0c6a2b11",
"agency_id": "2e800fb6-0bbf-4fc1-b0bd-0f3be3b5bcc4",
"currency_code": "NGN",
"available_balance": 9250000.00,
"created_at": "2025-01-14T09:02:41.000000+00:00",
"updated_at": "2026-08-15T11:30:55.000000+00:00"
}
],
"meta": {
"agencyId": "2e800fb6-0bbf-4fc1-b0bd-0f3be3b5bcc4",
"environment": "live"
}
}Field reference
| Field | Description |
|---|---|
id | Balance UUID — use as {balance_id} for the history endpoint |
agency_id | Agency UUID |
currency_code | ISO 4217 currency code (e.g. EGP, EUR, NGN, DZD, USD, INR) |
available_balance | Usable balance, rounded to 2 decimal places |
created_at | When the balance row was created |
updated_at | Last movement against this balance |