Honeycluster Docs – Get transaction history for an NFT (Clio only)

NFT Methods

Get transaction history for an NFT (Clio only)

wss://honeycluster.io

rpc method: nft_history

Returns the transaction history for a specific NFToken. Only available on Clio servers.

Try it now

Response · nft_history WS Response

{
  "result": {
    "nft_id": "00080000B4F4AFC5984A241ACF7DBAF0FA866A7B95C0A4E8166DC5230000001B",
    "ledger_index_min": 32570,
    "ledger_index_max": 89012345,
    "transactions": [
      {
        "meta": {
          "TransactionResult": "tesSUCCESS"
        },
        "tx": {
          "TransactionType": "NFTokenMint",
          "hash": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7"
        },
        "validated": true
      }
    ]
  },
  "status": "success",
  "type": "response",
  "id": 1
}

Request Message

nft_history WS Request

application/json

Get transaction history for an NFT (Clio only)

Field	Type	Description
`command` required	string	WebSocket command name
`id`	object	Client-supplied identifier to correlate requests with responses.
`nft_id`	string	The 256-bit hex NFTokenID to retrieve history for.
`ledger_index_min`	integer	Minimum ledger index to search.
`ledger_index_max`	integer	Maximum ledger index to search.
`ledger_index`	object	A ledger index (sequence number) or shortcut string identifying which ledger to use.
`ledger_hash`	string	256-bit hex hash identifying a specific ledger version.
`binary`	boolean	If true, return data in binary (hex) format instead of JSON.
`forward`	boolean	If true, return results sorted in ascending (oldest-first) order.
`limit`	integer	Maximum number of results to return. Clio servers may return more than this.
`marker`	object	Opaque pagination marker from a previous response. Pass unchanged to fetch the next page.
`api_version`	object	API version for the response format. Version 2 is the default for rippled 2.0+.

Example

Json

{
  "command": "nft_history",
  "id": 1,
  "nft_id": "00080000B4F4AFC5984A241ACF7DBAF0FA866A7B95C0A4E8166DC5230000001B",
  "ledger_index_min": -1,
  "ledger_index_max": -1,
  "limit": 10
}

Response Message

nft_history WS Response

application/json

WebSocket response for nft_history

Field	Type	Description
`result`	object
`status`	enum<string>	Available `successerror`
`type`	string
`id`	stringnumber	Echo of the client-provided correlation ID

Example

Json

{
  "result": {
    "nft_id": "00080000B4F4AFC5984A241ACF7DBAF0FA866A7B95C0A4E8166DC5230000001B",
    "ledger_index_min": 32570,
    "ledger_index_max": 89012345,
    "transactions": [
      {
        "meta": {
          "TransactionResult": "tesSUCCESS"
        },
        "tx": {
          "TransactionType": "NFTokenMint",
          "hash": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7"
        },
        "validated": true
      }
    ]
  },
  "status": "success",
  "type": "response",
  "id": 1
}

Request

Payload · JSON

const ws = new WebSocket('wss://honeycluster.io');

ws.addEventListener('open', () => {
  const request = {
    "command": "nft_history",
    "id": 1,
    "nft_id": "00080000B4F4AFC5984A241ACF7DBAF0FA866A7B95C0A4E8166DC5230000001B",
    "ledger_index_min": -1,
    "ledger_index_max": -1,
    "limit": 10
  };
  ws.send(JSON.stringify(request));
});

ws.addEventListener('message', (event: MessageEvent<string>) => {
  const response: unknown = JSON.parse(event.data);
  console.log(response);
  ws.close();
});

Response · nft_history WS Response

{
  "result": {
    "nft_id": "00080000B4F4AFC5984A241ACF7DBAF0FA866A7B95C0A4E8166DC5230000001B",
    "ledger_index_min": 32570,
    "ledger_index_max": 89012345,
    "transactions": [
      {
        "meta": {
          "TransactionResult": "tesSUCCESS"
        },
        "tx": {
          "TransactionType": "NFTokenMint",
          "hash": "E08D6E9754025BA2534A78707605E0601F03ACE063687A0CA1BDDACFCD1698C7"
        },
        "validated": true
      }
    ]
  },
  "status": "success",
  "type": "response",
  "id": 1
}