/accounts/well-knownaccount-listWellKnownPaginated list of accounts the indexer has curated metadata for — verified entities, exchanges, issuers, validators, launchpads, AMMs, and other identified actors. Each row carries the address plus metadata (name, description, icon, banner, social links, category, verified / KYC flags, advisory). Filter by category (e.g. exchange, issuer, validator), by verified=true for only attested entities, or by kyc=true for KYC'd issuers; combine for tighter scoping. Sort defaults to name ascending so directory-style UIs paginate alphabetically. Use this to render an entity directory or a 'known-accounts' picker without scanning the full account_data table.
| Name | Location | Details |
|---|---|---|
BearerAuth | Authorization header · bearer | JWT issued by the Honeycluster auth service for the `indexer` audience. Present as `Authorization: Bearer <token>`. |
| Name | Type | Default | Description |
|---|---|---|---|
page | integer | 1 | |
pageSize | integer | 20 | |
category | enum<string> | Available exchangeissuerprojectvalidatorlaunchpadammgatewaybroker | |
verifiedOnly | boolean | false | |
kycOnly | boolean | false | |
search | string | ||
sort | enum<string> | "name" | Available nameverifiedcategoryupdated |
sortDir | enum<string> | "desc" | Available ascdesc |
| Field | Type | Description |
|---|---|---|
items | object[] | Items on the current page. |
items[]. | string | XRPL classic address (r-address). |
items[]. | object | Curated display name. Null when no metadata curator has named the account yet. |
items[]. | object | Curated description / blurb. |
items[]. | object | CDN-mirrored icon URL. Null when no icon has been resolved. |
items[]. | object | CDN-mirrored banner / cover URL. |
items[]. | object | Free-form map of social platform → URL (twitter, telegram, discord, …). |
items[]. | object | Classification (`exchange` / `issuer` / `project` / `validator` / `launchpad` / `amm` / `gateway` / `broker` / `other`). Null when uncategorized. |
items[]. | boolean | |
items[]. | boolean | |
items[]. | boolean | |
items[]. | boolean | |
items[]. | boolean | |
items[]. | object | Source of the verified flag (`xrpscan`, `bithomp`, `manual`, …). Null when unverified. |
items[]. | boolean | |
items[]. | object | |
items[]. | object | Advisory severity (`caution` / `warning` / `danger`). Null when no advisory. |
items[]. | object | |
items[]. | integer | Last metadata refresh, Unix-seconds. |
page | integer | 1-indexed page number of the returned page. |
pageSize | integer | Items per page (echoed from the request). |
total | integer | Total number of items across all pages. |
pageCount | integer | Total number of pages at the requested pageSize. |
{
"items": [
{
"address": "string",
"name": "string",
"description": "string",
"iconUrl": "string",
"bannerUrl": "string",
"socialLinks": {},
"category": "string",
"isLaunchpad": false,
"isBroker": false,
"isExchange": false,
"isValidator": false,
"verified": false,
"verifiedBy": "string",
"kycVerified": false,
"kycProvider": "string",
"advisorySeverity": "string",
"advisoryMessage": "string",
"updatedAt": 1745798400
}
],
"page": 0,
"pageSize": 0,
"total": 0,
"pageCount": 0
}| Field | Type | Description |
|---|---|---|
message | string | The error message |
code | string | The error code |
issues | object[] | An array of issues that were responsible for the error |
issues[]. | string |
{
"code": "BAD_REQUEST",
"message": "Invalid input data",
"issues": []
}| Field | Type | Description |
|---|---|---|
message | string | The error message |
code | string | The error code |
issues | object[] | An array of issues that were responsible for the error |
issues[]. | string |
{
"code": "UNAUTHORIZED",
"message": "Authorization not provided",
"issues": []
}| Field | Type | Description |
|---|---|---|
message | string | The error message |
code | string | The error code |
issues | object[] | An array of issues that were responsible for the error |
issues[]. | string |
{
"code": "FORBIDDEN",
"message": "Insufficient access",
"issues": []
}| Field | Type | Description |
|---|---|---|
message | string | The error message |
code | string | The error code |
issues | object[] | An array of issues that were responsible for the error |
issues[]. | string |
{
"code": "NOT_FOUND",
"message": "Not found",
"issues": []
}| Field | Type | Description |
|---|---|---|
message | string | The error message |
code | string | The error code |
issues | object[] | An array of issues that were responsible for the error |
issues[]. | string |
{
"code": "INTERNAL_SERVER_ERROR",
"message": "Internal server error",
"issues": []
}