GET /testnet/{address}
GET

/v1/testnet/{address}

Live Testnet XRP balance, reserve, sequence and settings of an account, straight from the network

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/testnet/rh7BTtaMxPfbbP8fmgdH5zrDspoNvgZhcz
Path parameterValueDescription
addressAn XRPL account, its r-address
curl 'https://api.xrpl.to/v1/testnet/rh7BTtaMxPfbbP8fmgdH5zrDspoNvgZhcz'

Response

200Example response743 ms · just now · 0.5 KB · 21 lines
https://api.xrpl.to/v1/testnet/rh7BTtaMxPfbbP8fmgdH5zrDspoNvgZhcz
{
  "address": "rh7BTtaMxPfbbP8fmgdH5zrDspoNvgZhcz",
  "activated": true,
  "balance": "7399976",
  "balanceXRP": "7.399976",
  "reserve": {
    "baseReserveXRP": 1,
    "ownerReserveXRP": 0.2,
    "ownerCount": 32,
    "totalReserveXRP": "7.4",
    "totalReserveDrops": "7400000"
  },
  "available": {
    "drops": "0",
    "xrp": "0"
  },
  "sequence": 21124946,
  "domain": "trader-1.example",
  "domainHex": "7472616465722D312E6578616D706C65",
  "flags": 0
}
Shapeas documented
{
  address,
  activated,
  balance (drops),
  balanceXRP,
  reserve: {
    baseReserveXRP,
    ownerReserveXRP,
    ownerCount,
    totalReserveXRP
  },
  available: { drops, xrp },
  sequence,
  domain (the Domain field as text),
  domainHex,
  flags,
  ledgerIndex
}

What it does

Live Testnet XRP balance, reserve, sequence and settings of an account, straight from the network

Start at GET /v1/testnet/fixtures: it names live accounts, a busy token, an NFT with offers and one of every ledger object that xrpl.to keeps alive on Testnet, plus a real transaction of every type. The busiest token gains holders every hour, so its GET /v1/testnet/tokens/{md5}/holders is the place to test paginating a long list. Testnet resets without warning; the data is rebuilt from the chain within minutes, and only objects touched since count. Open the Testnet sandbox →
OpenAPI