Honeycluster Docs – List NFT sales

nftokens

List NFT sales

get

/nft/trades

operationId: nft-trades

Returns NFT sales — transfers that include a non-null amount, i.e. the transfer corresponds to an accepted buy or sell offer. Filter by tokenId, by issuer (matches NFTs minted by that account), or by account (matches trades where the account appears as buyer or seller). Filters combine with AND semantics.

Authorizations

Name	Location	Details
`BearerAuth`	Authorization header · bearer	JWT issued by the Honeycluster auth service for the `indexer` audience. Present as `Authorization: Bearer <token>`.

Query Parameters

Name	Type	Default
`cursor`	string
`limit`	integer	`20`
`tokenId`	string
`issuer`	string
`account`	string

Responses

200

application/json

Successful response

Field	Type	Description
`items`	object[]	Page of results.
`items[].id`	string	UUID — part of the composite PK (id, timestamp).
`items[].tokenId`	string	NFTokenID that was transferred.
`items[].fromAccount`	string	Previous owner XRPL address.
`items[].toAccount`	string	New owner XRPL address.
`items[].amount`	object
`items[].currency`	object
`items[].issuer`	object
`items[].txHash`	string	Transaction hash of the transfer.
`items[].ledgerIndex`	integer	Ledger sequence of the transfer.
`items[].timestamp`	integer	When the transfer occurred on-ledger, Unix-seconds.
`items[].transferType`	string	Transfer kind: `sale` \| `gift` \| `mint` \| `burn`.
`items[].brokerMarketplace`	object
`items[].createdAt`	integer	Record creation timestamp, Unix-seconds.
`nextCursor`	object	Cursor to fetch the next page, or null if this is the last page.

Example

Json

{
  "items": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "tokenId": "string",
      "fromAccount": "string",
      "toAccount": "string",
      "amount": "string",
      "currency": "string",
      "issuer": "string",
      "txHash": "string",
      "ledgerIndex": 0,
      "timestamp": 1745798400,
      "transferType": "string",
      "brokerMarketplace": "string",
      "createdAt": 1745798400
    }
  ],
  "nextCursor": "string"
}

400

application/json

Invalid input data

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[].message`	string

Example

Json

{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}

401

application/json

Authorization not provided

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[].message`	string

Example

Json

{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}

403

application/json

Insufficient access

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[].message`	string

Example

Json

{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}

404

application/json

Not found

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[].message`	string

Example

Json

{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}

500

application/json

Internal server error

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[].message`	string

Example

Json

{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}