Consultar saldo de la cuenta

GET /api/balance

GET https://api.avista.global/api/balance

Requiere un Bearer token en el header Authorization. Vea Generar Token para obtener uno.

Retorna el saldo bruto, bloqueado y neto de la cuenta autenticada.

Autenticación

Requiere un Bearer token en el header Authorization.

Ejemplos de Código

cURL

curl -X GET "https://api.avista.global/api/balance" \
  -H "Authorization: Bearer $AVISTA_TOKEN"

const axios = require('axios');

const response = await axios.get('https://api.avista.global/api/balance', {
  headers: { 'Authorization': `Bearer ${process.env.AVISTA_TOKEN}` },
});
console.log(response.data);

import os, requests

response = requests.get(
    'https://api.avista.global/api/balance',
    headers={'Authorization': f'Bearer {os.environ["AVISTA_TOKEN"]}'},
)
print(response.json())

$ch = curl_init('https://api.avista.global/api/balance');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('AVISTA_TOKEN'),
    ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.avista.global/api/balance"))
    .header("Authorization", "Bearer " + System.getenv("AVISTA_TOKEN"))
    .GET()
    .build();
HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Respuesta (200)

Campo	Tipo	Descripción
`grossBalance`	number	Saldo bruto (total disponible + bloqueado)
`blockedBalance`	number	Saldo bloqueado (reservado para operaciones pendientes)
`netBalance`	number	Saldo neto (disponible para uso)
`consultedAt`	string	Fecha y hora de la consulta (ISO 8601)

{
  "grossBalance": 48734.90,
  "blockedBalance": 0,
  "netBalance": 48734.90,
  "consultedAt": "2025-11-19T20:18:29.384Z"
}

Errores

Estado	Descripción
401	Token inválido, expirado o faltante