Skip to main content

nft_history RPC Method

Asks the Clio server for past transaction metadata for the NFT being queried

Updated on
Oct 4, 2023

nft_history RPC Method

Please note that the response for this method may varies depending upon the binary field.

Parameters

nft_id
string
REQUIRED
The unique identifier of a NFToken object
ledger_index_min
integer
REQUIRED
The earliest ledger from which to include NFTs
ledger_index_max
string
REQUIRED
The most recent ledger to include NFTs from
ledger_hash
string
A 20-byte hex string for identifying the ledger version. Please note that if the ledger version, Clio uses the latest validated ledger
ledger_index
string
The index of the ledger to retrieve information from
binary
string
REQUIRED
If set to true, returns transactions as hex strings instead of JSON
forward
string
REQUIRED
If set to true, returns values indexed with the oldest ledger first
limit
string
REQUIRED
It limits the number of NFT buy offers to retrieve. This value cannot be lower than 50 or more than 500. The default is 250
marker
string
The value from a previous paginated respons

Returns

result
object
The details of the result
ledger_index_min
integer
The ledger index of the earliest ledger actually searched for transactions
ledger_index_max
integer
The ledger index of the most recent ledger actually searched for transactions
transactions
array
An array of transactions matching the request criteria, which contains the following fields:
meta
object
If binary is true, then it returns the hex string of the transaction metadata. Otherwise, the transaction metadata is included in JSON format
AffectedNodes
array
The list of ledger objects that were created, deleted, or modified by this transaction
CreatedNode
object
A CreatedNode object which contains the following fields:
LedgerEntryType
string
The type of ledger object that was created
LedgerIndex
string
The ID of this ledger object in the ledger's state tree. Please note this is not same as ledger_index
NewFields
object
The content field of the newly created ledger object. The fields present in this object will depend on the type of ledger object created
NFTokens
array
A list of NFTokens
NFToken
object
The NFToken object which contain the information regarding the NFT token
NFTokenID
string
The NFT token id
URI
string
The uniform resource identifier of the token
TransactionIndex
integer
The transaction's position within the ledger that included it
TransactionResult
string
A result code indicating whether the transaction succeeded or how it failed
tx
object
The transaction object which contains the following fields:
Account
string
The account address
Fee
string
The fee paid for the NFT transaction
Flags
integer
The flag value associated with the transaction
LastLedgerSequence
integer
The last ledger sequence number at which this transaction is valid
NFTokenTaxon
integer
The taxon or classification of the non-fungible token
Sequence
integer
The sequence number of the account that sent the NFT transaction
SigningPubKey
string
The public key used for signing the NFT transaction
TransactionType
string
The type of transaction
TransferFee
integer
The fee associated with transferring the NFT
TxnSignature
string
The signature of the transaction
URI
string
The Uniform Resource Identifier (URI) associated with the NFT
hash
string
The hash of the transaction
ledger_index
integer
The index of the ledger to retrieve information from
date
integer
The timestamp of the transaction, represented as the number of seconds since the Unix epoch
validated
boolean
If it is true, the information in this response comes from a validated ledger version
nft_id
string
The NFT id
validated
boolean
It indicates whether or not the transaction is included in a validated ledger
warnings
array
An array of warning objects, each containing the following fields:
id
integer
The ID of the warning
message
string
The warning message
Request
1
curl https://docs-demo.xrp-mainnet.quiknode.pro/ \
2
  -X POST \
3
  -H "Content-Type: application/json" \
4
  --data '{
5
    "method": "nft_history",
6
    "params": [{
7
        "nft_id": "00080000B4F4AFC5FBCBD76873F18006173D2193467D3EE70000099B00000000"
8
    }],"id":1,"jsonrpc":"2.0"}'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free