/nft/collectionsnft-collectionsPaginated list of known NFT collections (derived from the (issuer, taxon) pair on mint), ordered newest-first. Uses 1-indexed page + pageSize and returns total / pageCount alongside the items. Optional issuer filter narrows to collections minted by a single account. Use /nft/collection to fetch a specific collection with its tokens embedded.
| 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 | |
issuer | string | ||
search | string | ||
includeEmpty | boolean | ||
sort | enum<string> | "top" | Available createdupdatedtotal_volumetoken_countfloor_pricetop |
sortDir | enum<string> | "desc" | Available ascdesc |
metadata | boolean | ||
metrics | boolean |
| Field | Type | Description |
|---|---|---|
items | object[] | Items on the current page. |
items[]. | string | Internal UUID primary key for the collection. |
items[]. | string | XRPL address that minted the collection. |
items[]. | string | Canonical collection slug — `<issuer>:<taxon>`. Use the per-collection sub-routes (`/nft/collection/...`) keyed by this slug to drill into traits, holders, traders, etc. |
items[]. | integer | NFToken taxon grouping identifier. |
items[]. | integer | Record creation timestamp, Unix-seconds. |
items[]. | integer | Record update timestamp, Unix-seconds. |
items[]. | object | Curated / slow-changing metadata about the collection. Present when `metadata=true` (the default); omitted when the caller passes `metadata=false`. |
items[]. | object | Collection display name. |
items[]. | object | Collection description text. |
items[]. | object | Collection cover / banner image URL. |
items[]. | object | Live / rolling sales and floor metrics, plus lifetime totals. Present when `metrics=true`; omitted when the caller leaves it at the default `false`. |
items[]. | integer | Number of NFTs minted in this collection. |
items[]. | object | Current lowest active sell offer across the collection, decimal XRP. NULL when no open sell offers exist. (Floor as a live state, not a window.) |
items[]. | string | Cumulative lifetime trade volume, decimal XRP. |
items[]. | object | Minimum observed sale price per window. `value` is the window minimum; `change_*` compares to the prior same-length window. |
items[]. | object | |
items[]. | object | |
items[]. | object | Summed XRP-denominated sale volume per window. |
items[]. | object | |
items[]. | object | |
items[]. | object | Count of sales per window. |
items[]. | object | |
items[]. | object | |
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": [
{
"id": "00000000-0000-0000-0000-000000000000",
"issuer": "string",
"slug": "string",
"taxon": 0,
"createdAt": 1745798400,
"updatedAt": 1745798400,
"metadata": {
"name": "string",
"description": "string",
"image_url": "string"
},
"metrics": {
"token_count": 0,
"current_floor": "string",
"total_volume": "string",
"floor": {
"last_24h": {
"value": "string",
"change_absolute": "string",
"change_percent": "string"
},
"last_7d": {
"value": "string",
"change_absolute": "string",
"change_percent": "string"
}
},
"volume": {
"last_24h": {
"value": "string",
"change_absolute": "string",
"change_percent": "string"
},
"last_7d": {
"value": "string",
"change_absolute": "string",
"change_percent": "string"
}
},
"sales": {
"last_24h": {
"value": 0,
"change_absolute": 0,
"change_percent": "string"
},
"last_7d": {
"value": 0,
"change_absolute": 0,
"change_percent": "string"
}
}
}
}
],
"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": []
}