Obtener Saldo
Este endpoint devuelve el saldo actual de la billetera del usuario autenticado.
POST /v1/balance
Solicitud
No se requieren parámetros para esta solicitud.
bash
#!/bin/bash
API_TOKEN="your_api_token"
API_SECRET="your_api_secret"
REQUEST_BODY='{}'
# Calcular firma
SIGNATURE=$(echo -n "${REQUEST_BODY}${API_SECRET}" | sha256sum | cut -d' ' -f1)
# Realizar solicitud a la API
curl -X POST "https://api.tronzap.com/v1/balance" \
-H "Authorization: Bearer ${API_TOKEN}" \
-H "X-Signature: ${SIGNATURE}" \
-H "Content-Type: application/json" \
-d "${REQUEST_BODY}"
javascript
const crypto = require('crypto');
const axios = require('axios');
const apiToken = 'your_api_token';
const apiSecret = 'your_api_secret';
const requestBody = JSON.stringify({});
// Calcular firma
const signature = crypto
.createHash('sha256')
.update(requestBody + apiSecret)
.digest('hex');
// Realizar solicitud a la API
axios({
method: 'post',
url: 'https://api.tronzap.com/v1/balance',
headers: {
'Authorization': `Bearer ${apiToken}`,
'X-Signature': signature,
'Content-Type': 'application/json'
},
data: requestBody
})
.then(response => console.log(response.data))
.catch(error => console.error(error));
php
<?php
$apiToken = 'your_api_token';
$apiSecret = 'your_api_secret';
$requestBody = json_encode([]);
// Calcular firma
$signature = hash('sha256', $requestBody . $apiSecret);
// Realizar solicitud a la API
$ch = curl_init('https://api.tronzap.com/v1/balance');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $requestBody);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer ' . $apiToken,
'X-Signature: ' . $signature,
'Content-Type: application/json'
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
python
import hashlib
import json
import requests
api_token = 'your_api_token'
api_secret = 'your_api_secret'
request_body = json.dumps({})
# Calcular firma
signature = hashlib.sha256((request_body + api_secret).encode()).hexdigest()
# Realizar solicitud a la API
headers = {
'Authorization': f'Bearer {api_token}',
'X-Signature': signature,
'Content-Type': 'application/json'
}
response = requests.post(
'https://api.tronzap.com/v1/balance',
headers=headers,
data=request_body
)
print(response.json())
Respuesta
La respuesta proporciona el saldo actual de la billetera del usuario autenticado y la dirección TRON asociada.
Campos de Respuesta
Campo | Tipo | Descripción |
---|---|---|
code | integer | Código de respuesta (0 = éxito) |
result | object | Datos de respuesta |
result.balance | float | Saldo actual |
result.address | string | Dirección TRON del usuario |
Ejemplo de Respuesta
json
{
"code": 0,
"result": {
"balance": 100.50,
"address": "your-tron-address"
}
}
Posibles Errores
Código de Error | Descripción |
---|---|
1 | Error de autenticación (token o firma incorrectos) |
2 | Servicio o parámetros inválidos |
5 | Billetera no encontrada |
500 | Error interno del servidor |