Get Balance API

GET /api/v1/get-balance?clientId=CLIENT_001

{
  "status": "success",
  "message": "Balance retrieved successfully",
  "data": {
    "userId": 123,
    "clientId": "CLIENT_001",
    "balance": 1500.50,
    "updatedAt": "2026-02-01T14:30:00.000Z"
  }
}

{
  "status": "failed",
  "message": "Validation failed",
  "data": {
    "errors": {
      "clientId": ["The clientId field is required."]
    }
  }
}

{
  "status": "failed",
  "message": "User not found",
  "data": null
}

{
  "status": "error",
  "message": "Invalid signature",
  "data": null
}

{
  "status": "failed",
  "message": "Failed to get balance",
  "data": {
    "error": "Database connection failed"
  }
}

curl -X GET "https://wdcf.xerve.online/api/v1/get-balance?clientId=CLIENT_001" \
  -H "x-signature: YOUR_SIGNATURE" \
  -H "x-timestamp: 1706802000"

import axios from 'axios';
// Import your signature generation function (see Overview)
import { generateSignature } from './signature-utils';

const API_BASE_URL = 'https://wdcf.xerve.online';
const CLIENT_SECRET = 'your-secret-key';

async function getBalance(clientId: string) {
  const timestamp = Math.floor(Date.now() / 1000);
  const payload = { clientId };

  // Generate signature (see Overview for implementation)
  const signature = generateSignature({
    method: 'GET',
    path: '/api/v1/get-balance',
    payload,
    secret: CLIENT_SECRET,
    timestamp
  });

  try {
    const response = await axios.get(
      `${API_BASE_URL}/api/v1/get-balance`,
      {
        params: payload,
        headers: {
          'x-signature': signature,
          'x-timestamp': timestamp.toString()
        }
      }
    );

    console.log('Balance:', response.data.data.balance);
    console.log('Updated at:', response.data.data.updatedAt);
    return response.data;
  } catch (error: any) {
    console.error('Error:', error.response?.data || error.message);
    throw error;
  }
}

// Usage
getBalance('CLIENT_001');

import requests
# Import your signature generation function (see Overview)
from signature_utils import generate_signature
import time

API_BASE_URL = 'https://wdcf.xerve.online'
CLIENT_SECRET = 'your-secret-key'

def get_balance(client_id: str):
    timestamp = int(time.time())
    payload = {"clientId": client_id}

    # Generate signature (see Overview for implementation)
    signature = generate_signature(
        method="GET",
        path="/api/v1/get-balance",
        payload=payload,
        secret=CLIENT_SECRET,
        timestamp=timestamp
    )

    headers = {
        "x-signature": signature,
        "x-timestamp": str(timestamp)
    }

    response = requests.get(
        f"{API_BASE_URL}/api/v1/get-balance",
        params=payload,
        headers=headers
    )

    response.raise_for_status()
    data = response.json()
    print(f"Balance: {data['data']['balance']}")
    print(f"Updated at: {data['data']['updatedAt']}")
    return data

# Usage
if __name__ == "__main__":
    get_balance("CLIENT_001")