GET /account/balance/{account}
GET

/v1/account/balance/{account}

XRP balance with reserves

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/account/balance/rJqiMb94hyz41SBTNr2AyPNW8AzELa8nE
Path parameterValueDescription
accountAn XRPL account, its r-address
Query parameterValueDescription
simplebool - minimal response
rankbool - include rank (slow)
curl 'https://api.xrpl.to/v1/account/balance/rJqiMb94hyz41SBTNr2AyPNW8AzELa8nE'

Response

200Example response1 ms · just now · 0.8 KB · 25 lines
https://api.xrpl.to/v1/account/balance/rJqiMb94hyz41SBTNr2AyPNW8AzELa8nE
{
  "success": true,
  "took": 1,
  "account": "rJqiMb94hyz41SBTNr2AyPNW8AzELa8nE",
  "balance": 206134579.448479,
  "total": 206134581.048479,
  "balanceDrops": 206134581048479,
  "spendableDrops": 206134579448479,
  "reserve": 1.6,
  "reserveDrops": 1600000,
  "reserveBaseDrops": 1000000,
  "reserveIncDrops": 200000,
  "ownerCount": 3,
  "sequence": 67314671,
  "flags": 0,
  "regularKey": null,
  "index": "FA35F8F693F566F164D678CBD24B21AA9A5FC5F0DD8D676A138404B8CBFE3132",
  "previousTxnID": "499B348CD1777771BDE61711892BA1B43575BEA2279B6DD761E671F38763E30D",
  "previousTxnLgrSeq": 108459329,
  "name": "Ripple",
  "inception": "2021-10-27T20:47:11.000Z",
  "parent": "rsV5XY4tm9dBN8mPX7RPEDuHLaA5fZjFSA",
  "parentTx": "3287AD0A193B6D3F4A46C315263A67F2C7F224534770F19579A85AD7B028DBB2",
  "activationAmount": 100
}
Shapeas documented
{
  balance,
  total,
  balanceDrops,
  spendableDrops,
  ownerCount,
  sequence,
  flags,
  regularKey (the key that signs besides the master,
  or null),
  reserve,
  reserveDrops,
  name,
  inception,
  parent,
  rank?
}

What it does

XRP balance with reserves

Notes
404 ACCOUNT_NOT_FOUND for an account the ledger does not hold. For one that was deleted the 404 also carries { deleted: true, deletedTx, deletedTo (where its remainder went), name, inception, parent, parentTx, activationAmount }
An account is its r-address, e.g. rN7n3473SaZBCG4dFL83w7a1RXtXtbk2D9.
OpenAPI