XRPL.to
GET /account/ancestry/{account}
GET

/v1/account/ancestry/{account}

Account ancestry tree

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/account/ancestry/rJqiMb94hyz41SBTNr2AyPNW8AzELa8nE
Path parameterValueDescription
accountAn XRPL account, its r-address
Query parameterValueDescription
directionup|down|both
limitint (max 200)
include_tokensbool
token_limitint (1-500, default 100)
curl 'https://api.xrpl.to/v1/account/ancestry/rJqiMb94hyz41SBTNr2AyPNW8AzELa8nE'

Response

200Example response5 ms · just now · 2.6 KB · 85 lines
https://api.xrpl.to/v1/account/ancestry/rJqiMb94hyz41SBTNr2AyPNW8AzELa8nE
{
  "account": "rJqiMb94hyz41SBTNr2AyPNW8AzELa8nE",
  "ancestors": [
    {
      "address": "rsV5XY4tm9dBN8mPX7RPEDuHLaA5fZjFSA",
      "tx": "3287AD0A193B6D3F4A46C315263A67F2C7F224534770F19579A85AD7B028DBB2",
      "inception": "2021-10-27T20:47:11.000Z",
      "childName": "Ripple",
      "name": null,
      "tokensCreated": 0
    },
    {
      "address": "rpcRgbYy9CUAYADeueKmAKZz12wXi9fVNS",
      "tx": "43EC923FBEFA279E3599F2B88B520356B506BEBB816C7D44B0585BAF28266DE8",
      "inception": "2013-11-15T00:39:00.000Z",
      "name": null,
      "tokensCreated": 3
    },
    {
      "address": "r9H8UWStzcajob8qkL7ZNQXjFpRfEnEvyE",
      "tx": "D1F8285B6115A3C6A694827CDB10DFDEF386A5822F00C62442BB404CD7066886",
      "inception": "2013-05-28T21:33:20.000Z",
      "name": null,
      "tokensCreated": 0
    },
    {
      "address": "rJR7gjNe3DpJ7kpB4CHBxjDKfwVMpTKPpj",
      "tx": "A48F62CB9427E4EB1FACBB78ACEFDD64815B44B21AA059A3FE231E41D23469DD",
      "inception": "2013-04-18T02:55:40.000Z",
      "name": "Ripple",
      "tokensCreated": 102
    },
    {
      "address": "r3kmLJN5D28dHuH8vZNUZpMC43pEHpaocV",
      "tx": "20FA74348BB95508061D3287218EC9EB11752AF4FCFE7146E73438B0EF25009A",
      "inception": "2013-02-20T23:29:00.000Z",
      "childName": "Ripple",
      "name": "Ripple",
      "tokensCreated": 38
    }
  ],
  "children": [
    {
      "address": "rhSw3e7qdquJwewr6AUZ8dEQ9cY1JTBnT3",
      "name": null,
      "tx": "3190EFA6DD593EC750222C4820F1AE3E4CC59E9FD9F695AE1ADB4D46C179FF15",
      "inception": "2026-08-26T17:45:10.000Z",
      "tokensCreated": 0
    },
    {
      "address": "rJbKqzUs93yMFtjrCfUamQDhtBJH9iaCzE",
      "name": null,
      "tx": "4E21D2F22A13EC6809A27B523006739C343CE5AF9EEB788A831E0B2B63357206",
      "inception": "2026-08-26T17:43:10.000Z",
      "tokensCreated": 0
    },
    {
      "address": "rwhZFXCcrekKtQ1JBtyzUM5usdX7K5cDo8",
      "name": null,
      "tx": "108D6594C9DA52F37462D1B7EE82AAC0070994C51332C0A94988E717717F74E3",
      "inception": "2026-07-01T22:29:21.000Z",
      "tokensCreated": 0
    },
    {
      "address": "rHgk8sXaXEG4kFDXJgCoKk2WaWPBYXvhWr",
      "name": null,
      "tx": "C33DBFACB8ADC58E47CC95CD29E81906707F2388C04E99A91D53BA1810646A9F",
      "inception": "2026-07-01T22:29:10.000Z",
      "tokensCreated": 0
    },
    {
      "address": "r4jxYbWYmYGdSuAmoFQ7yHCMXbwtbdsdfL",
      "name": null,
      "tx": "8E29FB926F1406A84147A800CA3DC018081879B18C167F53F143FF7BC3303015",
      "inception": "2026-06-12T17:36:20.000Z",
      "tokensCreated": 0
    }
  ],
  "stats": {
    "childrenCount": 35,
    "tokensCreated": 11,
    "ancestorDepth": 5,
    "isTokenCreator": true
  }
}

Long arrays and strings are shortened in the example; Send request for the full answer.

What it does

Account ancestry tree

Notes
Requires Developer tier or above (403 otherwise)
An account is its r-address, e.g. rN7n3473SaZBCG4dFL83w7a1RXtXtbk2D9.
OpenAPI
PrevGET/account/info/{account}NextPOST/account/names