Get Balance

Retrieve the current balance for the authenticated user

GET /api/v1/balance

Get Balance

cURL

curl --request GET \
  --url https://api.example.com/api/v1/balance \
  --header 'Authorization: <authorization>'

Success Response

{
  "status": "success",
  "message": 10000
}

Authentication

This endpoint requires authentication. Include a valid JWT token in the Authorization header.

Authorization · string · required

Bearer token for authentication

Format: Bearer <your_jwt_token>

Response

status · string

The status of the request. Returns "success" on successful retrieval.

message · number

The user’s current account balance

Response Examples

Success Response

{
  "status": "success",
  "message": 10000
}

Unauthorized

{
  "error": "Unauthorized"
}

User Not Found

{
  "status": "error",
  "message": "User not found"
}

Token Expired

{
  "error": "Token expired or invalid ❌"
}

Error Codes

Status Code	Description
200	Balance retrieved successfully
401	Unauthorized - Missing or invalid authentication token
404	User not found
500	Internal server error or failed to fetch balance from database

Code Example

cURL

curl --location 'https://api.exness.com/api/v1/balance' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'

JavaScript

const response = await fetch('https://api.exness.com/api/v1/balance', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
  }
});

const data = await response.json();
console.log('Current balance:', data.message);

Python

import requests

url = 'https://api.exness.com/api/v1/balance'
headers = {
    'Authorization': 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
}

response = requests.get(url, headers=headers)
data = response.json()
print(f"Current balance: {data['message']}")