> ## Documentation Index
> Fetch the complete documentation index at: https://docs.validationcloud.io/llms.txt
> Use this file to discover all available pages before exploring further.

# nft_history

Returns past transaction metadata for the NFT being queried, oldest or newest first, with pagination.

This method will use `40` [Compute Units](/nodeapi/about/billing).

***

## Reference: [Here](https://xrpl.org/docs/references/http-websocket-apis/public-api-methods/clio-methods/nft_history)

## **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.

```json theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
// 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"
  }
}
```

<CodeGroup>
  ```bash title="mainnet" theme={"theme":{"light":"github-light","dark":"github-dark-default"}}
  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}]}'
  ```
</CodeGroup>

Over WebSocket, send `{"id":1,"command":"nft_history","nft_id":"0008170207397A8AA414511E6E0649C9980E185E1C19D74010CEAF0005E46EE3","limit":2}` to `wss://mainnet.xrpl.validationcloud.io/v1/<YOUR_API_KEY_HERE>`.

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.