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

Parameters

object

object

REQUIRED

The nft_history request object.

nft_id

string

REQUIRED

The unique identifier of a NFToken object

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

(Optional) An array of warning objects, each containing the following fields. Returned at the JSON-RPC response root on some servers and omitted from the result object

id

integer

The ID of the warning

message

string

The warning message

Request

1
curl -X POST "https://docs-demo.xrp-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "nft_history",
6
  "params": [
7
    {
8
      "nft_id": "00080000B4F4AFC5FBCBD76873F18006173D2193467D3EE70000099B00000000"
9
    }
10
  ],
11
  "id": 1
12
}'

1
curl -X POST "https://docs-demo.xrp-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "nft_history",
6
  "params": [
7
    {
8
      "nft_id": "00080000B4F4AFC5FBCBD76873F18006173D2193467D3EE70000099B00000000"
9
    }
10
  ],
11
  "id": 1
12
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'nft_history',
4
    params: [{"nft_id":"00080000B4F4AFC5FBCBD76873F18006173D2193467D3EE70000099B00000000"}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.xrp-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'nft_history',
4
    params: [{"nft_id":"00080000B4F4AFC5FBCBD76873F18006173D2193467D3EE70000099B00000000"}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.xrp-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
import requests
2
import json
3

4
url = "https://docs-demo.xrp-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "nft_history",
9
  "params": [
10
    {
11
      "nft_id": "00080000B4F4AFC5FBCBD76873F18006173D2193467D3EE70000099B00000000"
12
    }
13
  ],
14
  "id": 1
15
})
16
headers = {
17
  'Content-Type': 'application/json'
18
}
19

20
response = requests.request("POST", url, headers=headers, data=payload)
21

22
print(response.text)

1
import requests
2
import json
3

4
url = "https://docs-demo.xrp-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "nft_history",
9
  "params": [
10
    {
11
      "nft_id": "00080000B4F4AFC5FBCBD76873F18006173D2193467D3EE70000099B00000000"
12
    }
13
  ],
14
  "id": 1
15
})
16
headers = {
17
  'Content-Type': 'application/json'
18
}
19

20
response = requests.request("POST", url, headers=headers, data=payload)
21

22
print(response.text)

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.xrp-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "nft_history",
11
  params: [{"nft_id":"00080000B4F4AFC5FBCBD76873F18006173D2193467D3EE70000099B00000000"}]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.xrp-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "nft_history",
11
  params: [{"nft_id":"00080000B4F4AFC5FBCBD76873F18006173D2193467D3EE70000099B00000000"}]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

Response

1
{
2
  "result": {
3
    "nft_id": "00080000B4F4AFC5FBCBD76873F18006173D2193467D3EE70000099B00000000",
4
    "ledger_index_min": 32570,
5
    "ledger_index_max": 102609805,
6
    "transactions": [],
7
    "validated": true,
8
    "status": "success"
9
  },
10
  "warnings": [
11
    {
12
      "id": 2001,
13
      "message": "This is a clio server. clio only serves validated data. If you want to talk to rippled, include 'ledger_index':'current' in your request"
14
    }
15
  ]
16
}

1
{
2
  "result": {
3
    "nft_id": "00080000B4F4AFC5FBCBD76873F18006173D2193467D3EE70000099B00000000",
4
    "ledger_index_min": 32570,
5
    "ledger_index_max": 102609805,
6
    "transactions": [],
7
    "validated": true,
8
    "status": "success"
9
  },
10
  "warnings": [
11
    {
12
      "id": 2001,
13
      "message": "This is a clio server. clio only serves validated data. If you want to talk to rippled, include 'ledger_index':'current' in your request"
14
    }
15
  ]
16
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free