Sandbox version
For experimental use only. Proceed with caution.
nftokens
Get an account's cumulative NFT trading profile
get
/nft/trader/{account}
operationId: nft-traderProfile

Returns cumulative NFT trading stats for an XRPL account over the requested window. buys and sells reflect sale transfers only (gifts / mints / burns are excluded). Each topCollections entry carries the canonical issuer:taxon slug and the collection display name. windowDays=0 returns lifetime stats; otherwise the window is the trailing N days from now (default 30, max 365). Volume is summed in XRP drops only — non-XRP (IOU-denominated) sales contribute to counts but not to volume.

Unlock protected endpoints

Enter your Bearer token once to enable every protected route in this API reference.

HTTP bearer

Saved for this browser tab only. The credential is never sent until you test an endpoint.

Authorizations
NameLocationDetails
BearerAuthAuthorization header · bearerJWT issued by the Honeycluster auth service for the `indexer` audience. Present as `Authorization: Bearer <token>`.
Path Parameters
NameTypeDefaultDescription
account
required
string
XRPL classic address (r-address) to profile.
Query Parameters
NameTypeDefaultDescription
windowDays
integer30
Responses
200
application/json
Successful response
FieldTypeDescription
account
string
Echoed account.
buys
object
Buyer-side totals — sales where the account appears as the recipient.
buys.count
integer
Total NFT sales the account participated in on this side within the window.
buys.volumeXrpDrops
string
Sum of XRP-denominated sale amounts (drops) on this side within the window. Non-XRP (IOU) sales contribute to `count` but not to volume.
sells
object
Seller-side totals — sales where the account appears as the sender.
sells.count
integer
Total NFT sales the account participated in on this side within the window.
sells.volumeXrpDrops
string
Sum of XRP-denominated sale amounts (drops) on this side within the window. Non-XRP (IOU) sales contribute to `count` but not to volume.
collectionsCount
integer
Number of distinct NFT collections the account traded within the window.
topCollections
object[]
Top collections by XRP-denominated volume within the window. Capped at 10 entries.
topCollections[].slug
string
Canonical collection slug `issuer:taxon`. Use the collection-detail / floor-history endpoints to drill in.
topCollections[].name
object
Collection display name, when known. `null` otherwise.
topCollections[].tradeCount
integer
Total NFT sales the account participated in (buyer or seller) for this collection within the window.
topCollections[].volumeXrpDrops
string
Sum of XRP-denominated sale amounts (drops) for this collection within the window. Non-XRP sales contribute to `tradeCount` but not to volume.
Example
Json
{
  "account": "string",
  "buys": {
    "count": 0,
    "volumeXrpDrops": "string"
  },
  "sells": {
    "count": 0,
    "volumeXrpDrops": "string"
  },
  "collectionsCount": 0,
  "topCollections": [
    {
      "slug": "string",
      "name": "string",
      "tradeCount": 0,
      "volumeXrpDrops": "string"
    }
  ]
}
400
application/json
Invalid input data
FieldTypeDescription
message
string
The error message
code
string
The error code
issues
object[]
An array of issues that were responsible for the error
issues[].message
string
Example
Json
{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}
401
application/json
Authorization not provided
FieldTypeDescription
message
string
The error message
code
string
The error code
issues
object[]
An array of issues that were responsible for the error
issues[].message
string
Example
Json
{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}
403
application/json
Insufficient access
FieldTypeDescription
message
string
The error message
code
string
The error code
issues
object[]
An array of issues that were responsible for the error
issues[].message
string
Example
Json
{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}
404
application/json
Not found
FieldTypeDescription
message
string
The error message
code
string
The error code
issues
object[]
An array of issues that were responsible for the error
issues[].message
string
Example
Json
{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}
500
application/json
Internal server error
FieldTypeDescription
message
string
The error message
code
string
The error code
issues
object[]
An array of issues that were responsible for the error
issues[].message
string
Example
Json
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}