Get User Balances

Testing Env

https://partner-api-stage.p100.io

GET

/v1/user/{externalUserId}/balances

Retrieves the current balances for all cryptocurrencies and fiat currencies for a specific user. This endpoint provides a comprehensive overview of the user's financial assets within the system.

The endpoint returns detailed information about all fiat and crypto balances assigned to the user, including:

Current available amount for each currency

Currency name and type (fiat or crypto)

Wallet address (for crypto)

Exchange rate to EUR

Status of each balance (e.g., ACTIVE, WAITING_TO_BE_ACTIVATED)

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Path Params

Responses

🟢200Success

application/json

Body

🟠401Access Denied

🟠400P412: User not exist

🟠400P500: Unknown exception

🟠400P501: Service temporarily unavailable

🟠400P459: User not verified

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://partner-api-stage.p100.io/v1/user/6dc8bb2e-06a4-45ee-b55d-84a03ffa3f0a/balances' \
--header 'x-api-key: <api-key>'

Response Example

200 - Success

{
    "fiatBalances": [
        {
            "id": "32f1bde8-b657-4221-940a-2d73bc6d3b7d",
            "amount": "76.51",
            "name": "eur",
            "rate": 1,
            "status": "ACTIVE"
        }
    ],
    "cryptoBalances": [
        {
            "id": "12945229-16ad-4bc9-a756-3175464040c2",
            "amount": "6.03457325",
            "name": "pol",
            "wallet": "0x9538f2f50c0f31ed39384bd009b002e6a8828b78",
            "rate": 0.19094656,
            "networkConfig": {
                "polygon": {
                    "mainnet": false,
                    "name": "amoy",
                    "withdrawal": {
                        "feeWithdrawal": 0.001,
                        "minWithdrawal": 0.00005
                    },
                    "deposit": {
                        "minDeposit": 0
                    }
                }
            }
        },
        {
            "id": "44570191-e540-4e2c-8b11-1e0683e2378d",
            "amount": "0.03081738",
            "name": "eth",
            "wallet": "0x9538f2f50c0f31ed39384bd009b002e6a8828b78",
            "rate": 3308.6004075,
            "networkConfig": {
                "ethereum": {
                    "mainnet": false,
                    "name": "sepolia",
                    "withdrawal": {
                        "feeWithdrawal": 0.003,
                        "minWithdrawal": 0.0006
                    },
                    "deposit": {
                        "minDeposit": 0
                    }
                }
            }
        },
        {
            "id": "fcb36ff8-e1d8-416c-9edf-7df2f1300ee5",
            "amount": "0.97365396",
            "name": "ltc",
            "wallet": "MWuKZiDNyzJ8zFyP9DTyEevMyo2zXc3XoW",
            "rate": 95.22538992,
            "networkConfig": {
                "ltc": {
                    "mainnet": false,
                    "name": "test",
                    "withdrawal": {
                        "feeWithdrawal": 0.002,
                        "minWithdrawal": 0.001
                    },
                    "deposit": {
                        "minDeposit": 0
                    }
                }
            }
        },
        {
            "id": "f08723ed-a1d9-4be8-9b6f-6185eb007732",
            "amount": "0.00097829",
            "name": "btc",
            "wallet": "3MU2PysVY1yKPok1LRc5pCYxmXyNVV7whH",
            "rate": 102475.93641872,
            "networkConfig": {
                "btc": {
                    "mainnet": false,
                    "name": "test",
                    "withdrawal": {
                        "feeWithdrawal": 0.0003,
                        "minWithdrawal": 0.000001
                    },
                    "deposit": {
                        "minDeposit": 0
                    }
                }
            }
        },
        {
            "id": "e459d758-2e31-454d-9013-1834f6b6ae69",
            "amount": "99.773248",
            "name": "usdc",
            "wallet": "0x9538f2f50c0f31ed39384bd009b002e6a8828b78",
            "rate": 0.864933,
            "networkConfig": {
                "ethereum": {
                    "mainnet": false,
                    "name": "sepolia",
                    "withdrawal": {
                        "feeWithdrawal": 10,
                        "minWithdrawal": 1
                    },
                    "deposit": {
                        "minDeposit": 5
                    }
                },
                "polygon": {
                    "mainnet": false,
                    "name": "amoy",
                    "withdrawal": {
                        "feeWithdrawal": 0.5,
                        "minWithdrawal": 2
                    },
                    "deposit": {
                        "minDeposit": 0
                    }
                }
            }
        },
        {
            "id": "87a7c037-9bd5-491d-b69e-e71c8efc9c52",
            "amount": "398.33177493",
            "name": "doge",
            "wallet": "D7n7AbnNaicYojMvtJgphdcK1foMZrn9d3",
            "rate": 0.19318475,
            "networkConfig": {
                "doge": {
                    "mainnet": false,
                    "name": "test",
                    "withdrawal": {
                        "feeWithdrawal": 5,
                        "minWithdrawal": 0.01
                    },
                    "deposit": {
                        "minDeposit": 0
                    }
                }
            }
        }
    ]
}

Balances & Transaction History

Get User Transaction History