nft_history

​

Reference: Here

​

Parameters

• nft_id (string, required) A unique identifier for the non-fungible token (NFT).
• ledger_index_min (integer, optional) The earliest ledger to include. -1 means the earliest validated ledger available.
• ledger_index_max (integer, optional) The most recent ledger to include. -1 means the most recent validated ledger available.
• ledger_hash (string, optional) The unique hash of the ledger version to use.
• ledger_index (string or unsigned integer, optional) The ledger index of the ledger to use, or a shortcut string. Do not use closed or current; those forward the request to rippled, which does not support this method.
• binary (boolean, optional) If true, return transactions as hex strings instead of JSON. Defaults to false.
• forward (boolean, optional) If true, return values indexed with the oldest ledger first. Defaults to false.
• limit (unsigned integer, optional) Limit the number of transactions to retrieve. The server is not required to honor this value.
• marker (marker, optional) Value from a previous paginated response. Not stable if the server’s range of available ledgers changes.

​

Returns

• nft_id (string) The NFT this history is for.
• ledger_index_min (integer) The ledger index of the earliest ledger actually searched.
• ledger_index_max (integer) The ledger index of the most recent ledger actually searched.
• limit (integer) The limit value used in the request.
• marker (marker) Server-defined value indicating the response is paginated.
• transactions (array) Transactions that affected this NFT. Each has ledger_index, tx (or tx_blob), meta (or meta_blob) and validated.
• validated (boolean) If true, the information comes from a validated ledger version.

// Result
{
  "result": {
    "nft_id": "0008170207397A8AA414511E6E0649C9980E185E1C19D74010CEAF0005E46EE3",
    "ledger_index_min": 32570,
    "ledger_index_max": 107293004,
    "transactions": [
      {
        "meta": {
          "AffectedNodes": [
            // ...
          ],
          "TransactionIndex": 22,
          "TransactionResult": "tesSUCCESS"
        },
        "tx": {
          "Account": "rGNtXLja1ZJk2Kcum2wDdvaAk12pXHCcro",
          "Amount": "3350000",
          "Destination": "rpx9JThQ2y37FaGeeJP7PXDUVEXY3PHZSC",
          "Expiration": 844001353,
          "Fee": "13",
          "LastLedgerSequence": 107292948,
          "NFTokenID": "0008170207397A8AA414511E6E0649C9980E185E1C19D74010CEAF0005E46EE3",
          "Owner": "rS4dApSN93mKuMfM8qbmuVQbtGcQ5K6th",
          "Sequence": 106009547,
          "SigningPubKey": "ED6FD2104F1F63F2764F05BA060A4D55C79D6E580E9F880A20C8C1F4AF9CA318B9",
          "SourceTag": 101102979,
          "TransactionType": "NFTokenCreateOffer",
          "TxnSignature": "A1C150AEB44FE089BDC3FC0A92C96871DC4CBDE5...",
          "hash": "ED71E6DD9F80DF551976E54E72F46B9B96134DF47CB7AD1D7E7B4630E312C47C",
          "ledger_index": 107292935,
          "date": 843914952
        },
        "validated": true
      },
      // ...
    ],
    "validated": true,
    "marker": {
      "ledger": 107270035,
      "seq": 24
    },
    "limit": 2,
    "status": "success"
  }
}

curl https://mainnet.xrpl.validationcloud.io/v1/<YOUR_API_KEY_HERE> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{"method":"nft_history","params":[{"nft_id":"0008170207397A8AA414511E6E0649C9980E185E1C19D74010CEAF0005E46EE3","limit":2}]}'

This method is served by Clio, our full-history XRPL server, and is not available from rippled.