Ir al contenido
GET /v1/balances

XRP + token (trustline) balances

Pruébalo en vivo

10 llamadas gratis al día — sin registro, sin clave API. Pasa por el gateway de oanor.

Encabezados personalizados (opcional)
api.oanor.com/xrpl-api

Funciona. Consigue una clave API y úsala en tu proyecto.

Obtener una clave API

Fragmentos de código

curl "https://api.oanor.com/xrpl-api/v1/balances" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/xrpl-api/v1/balances", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/xrpl-api/v1/balances");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/xrpl-api/v1/balances",
    headers={"x-oanor-key": "oanor_test_..."}
)

Respuesta de ejemplo

Una respuesta real de este endpoint, capturada en la última comprobación de estado.

{
    "data": {
        "xrp": 56760.625556,
        "source": "XRP Ledger",
        "tokens": [
            {
                "limit": 0,
                "issuer": "rwdFmXzRpUC6DCcPedKSLaBZQyyCdnu72m",
                "balance": -0.1165139515638055,
                "currency": "USD",
                "currency_raw": "USD"
            },
            {
                "limit": 0,
                "issuer": "rD1jovjQeEpvaDwn9wKaYokkXXrqo4D23x",
                "balance": -1,
                "currency": "USD",
                "currency_raw": "USD"
            },
            {
                "limit": 0,
                "issuer": "rDv5FHeAdRSsUpSa1mLyrZKhSoRXzotCvY",
                "balance": -1,
                "currency": "USD",
                "currency_raw": "USD"
            },
            {
                "limit": 0,
                "issuer": "rUjbzuRoQagHet3XnygZkfaTFTFkMoD3YG",
                "balance": -99999899,
                "currency": "USD",
                "currency_raw": "USD"
            },
            {
                "limit": 0,
                "issuer": "rUjbzuRoQagHet3XnygZkfaTFTFkMoD3YG",
                "balance": -10000000,
                "currency": "CNY",
                "currency_raw": "CNY"
            },
            {
                "limit": 0,
                "issuer": "rfMwmKUJR53jbRratQVGmPJZLBZJiuKZ9a",
                "balance": -900000000,
                "currency": "USD",
                "currency_raw": "USD"
            },
            {
                "limit": 0,
                "issuer": "r9BFYMX3uNRpVkNXKihN7NmF1eBJvsXk4W",
                "balance": -900,
                "currency": "USD",
                "currency_raw": "USD"
            }
        ],
        "address": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
        "token_count": 7
    },
    "meta": {
        "timestamp": "2026-06-09T11:38:21.311Z",
        "request_id": "10fae255-e368-47d4-97ce-288655ee5fa5"
    },
    "status": "ok",
    "message": "Balances retrieved successfully",
    "success": true
}