Honeycluster Docs – Recent activity feed for a single NFT collection

nftokens

Recent activity feed for a single NFT collection

get

/nft/collection/{slug}/activity

operationId: nft-collectionActivityFeed

Collection-scoped alias of /nft/activity — returns the same unified activity feed (transfers + offer lifecycle events) filtered to NFTs belonging to the given collection. slug is the issuer:taxon pair moved from query into the URL path. All other semantics (ordering, cursor shape, type values, price conventions) match the global endpoint.

Authorizations

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

Path Parameters

Name	Type	Default	Description
`slug` required	string		Collection slug in `issuer:taxon` form. Example: `rvYAfWj5gh67oV6fW32ZzP3Aw4Eubs59B:42`.

Query Parameters

Name	Type	Default	Description
`cursor`	string
`limit`	integer	`50`

Responses

200

application/json

Successful response

Field	Type	Description
`items`	object[]	Activity rows ordered by timestamp descending (newest first). A stable `(ts DESC, txHash ASC)` total order keeps pagination deterministic across ties.
`items[].ts`	integer	Event timestamp, Unix-seconds.
`items[].type`	enum<string>	Event kind — 4 transfer sub-types (sale / gift / mint / burn) plus 3 offer-lifecycle events (offer_created / offer_accepted / offer_cancelled). Available `salegiftmintburnoffer_createdoffer_acceptedoffer_cancelled`
`items[].nftId`	string	On-chain NFTokenID (64-char hex) the event targets.
`items[].collectionId`	object	Internal UUID of the NFT collection the NFT belongs to, or `null` when the NFT has no resolved collection yet.
`items[].fromAccount`	object	Sender (transfer) or offer owner. `null` for mint events (no prior owner).
`items[].toAccount`	object	Recipient (transfer) or offer destination. `null` for un-restricted offers (any account can take) and for some transfer kinds.
`items[].priceXrpDrops`	object	Transacted amount in XRP drops (decimal string) when the underlying currency is `XRP`; `null` for IOU-denominated events and for offers/transfers without an amount.
`nextCursor`	object	Cursor for the next page, or `null` when this is the last page.

Example

Json

{
  "items": [
    {
      "ts": 1745798400,
      "type": "sale",
      "nftId": "string",
      "collectionId": "00000000-0000-0000-0000-000000000000",
      "fromAccount": "string",
      "toAccount": "string",
      "priceXrpDrops": "string"
    }
  ],
  "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": []
}