GET /account/search-by-name
GET

/v1/account/search-by-name

Search accounts by display name / X profile

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/account/search-by-name?q=ripple
Query parameterValueDescription
qstring (min 2 chars; name, domain, or X handle)
curl 'https://api.xrpl.to/v1/account/search-by-name?q=ripple'

Response

200Example response343 ms · just now · 1.7 KB · 46 lines
https://api.xrpl.to/v1/account/search-by-name?q=ripple
{
  "success": true,
  "resolvedName": "Ripple",
  "results": [
    {
      "address": "rMQ98K56yXJbDGv49ZSmW51sLn94Xe1mu1",
      "name": "Ripple",
      "desc": "Ripple is a US company that develops payment products on the XRP Ledger and issues the RLUSD stablecoin; this account is company-operated.",
      "twitter": "ripple",
      "walletIndex": 29,
      "logoUpdated": 1785160928001
    },
    {
      "address": "rKveEyR1SrkWbJX214xcfH43ZsoGMb3PEv",
      "name": "Ripple",
      "desc": "Ripple is a US company that develops payment products on the XRP Ledger and issues the RLUSD stablecoin; this account is company-operated.",
      "twitter": "ripple",
      "walletIndex": 39,
      "logoUpdated": 1785160927817
    },
    {
      "address": "r9NpyVfLfUG8hatuCCHKzosyDtKnBdsEN3",
      "name": "Ripple",
      "desc": "Ripple is a US company that develops payment products on the XRP Ledger and issues the RLUSD stablecoin; this account is company-operated.",
      "twitter": "ripple",
      "walletIndex": 9,
      "logoUpdated": 1785160928519
    },
    {
      "address": "rMhkqz3DeU7GUUJKGZofusbrTwZe6bDyb1",
      "name": "Ripple",
      "desc": "Ripple is a US company that develops payment products on the XRP Ledger and issues the RLUSD stablecoin; this account is company-operated.",
      "twitter": "ripple",
      "walletIndex": 28,
      "logoUpdated": 1785160928269
    },
    {
      "address": "rhtufNsYfrozs4GvSq4HMYcR9y3dg8FWdC",
      "name": "Ripple",
      "desc": "Ripple is a US company that develops payment products on the XRP Ledger and issues the RLUSD stablecoin; this account is company-operated.",
      "twitter": "ripple",
      "walletIndex": 52,
      "logoUpdated": 1785160928535
    }
  ]
}

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

Shapeas documented
{ success, resolvedName, results[] }

What it does

Search accounts by display name / X profile

An account is its r-address, e.g. rN7n3473SaZBCG4dFL83w7a1RXtXtbk2D9.
OpenAPI