# Get Currency Balance Retrieve wallet balance for a specific currency. Also used to create a new currency wallet if one does not exist. ## Get Balance ### Path Parameters ### Headers ### Response (200 OK) ```json { "success": true, "data": { "currency": "USD", "availableBalance": 250000, "totalBalance": 270000, "blockedBalance": 5000, "pendingBalance": 15000, "lifetimeBalance": 1500000, "lifetimeWithdrawn": 1230000, "lastUpdated": "2024-01-15T10:30:00.000Z", "status": "ACTIVE", "settlementFrequency": "daily" } } ``` --- ## Create Currency Wallet Creates a new wallet for the specified currency. ### Path Parameters ### Response (201 Created) ```json { "success": true, "data": { "currency": "EUR", "availableBalance": 0, "totalBalance": 0, "blockedBalance": 0, "pendingBalance": 0, "lifetimeBalance": 0, "lifetimeWithdrawn": 0, "lastUpdated": "2024-01-15T10:30:00.000Z", "status": "ACTIVE", "settlementFrequency": "manual" } } ``` ## Examples ```bash # Get balance for a currency curl -X GET "https://api.zenpays.com/merchant/api/v1/wallet/currency/USD" \ -H "Authorization: Bearer zp_test_xxxxx" \ -H "X-Timestamp: 2024-01-15T10:30:00.000Z" \ -H "X-Signature: a1b2c3d4e5f6..." \ -H "X-Secret-Salt: your_secret_salt" # Create a new currency wallet curl -X POST "https://api.zenpays.com/merchant/api/v1/wallet/currency/EUR" \ -H "Authorization: Bearer zp_test_xxxxx" \ -H "X-Timestamp: 2024-01-15T10:30:00.000Z" \ -H "X-Signature: a1b2c3d4e5f6..." \ -H "X-Secret-Salt: your_secret_salt" ``` ```javascript // Get balance for a currency const balance = await zenpays.wallet.getBalance('USD'); console.log(`Available: ${balance.availableBalance}`); // Create a new currency wallet const newWallet = await zenpays.wallet.create('EUR'); ```