Parameters

object

object

REQUIRED

The account_nfts request object.

account

string

REQUIRED

The XRP Ledger account for which NFT information is to be retrieved

ledger_index

string

The ledger index to query the NFT information from

Returns

result

object

The method returns a JSON object with the following properties:

account

string

The XRP Ledger account

validated

boolean

Indicates if the information is from a validated ledger

limit

integer

The maximum number of NFTs returned

account_nfts

array

A list of NFToken objects associated with the account. Each NFToken object contains the following properties:

Flags

string

Flags associated with the NFToken

Issuer

string

The issuer of the NFToken

NFTokenID

string

The unique identifier of the NFToken

NFTokenTaxon

string

The taxonomic classification of the NFToken

URI

string

The URI associated with the NFToken

nft_serial

string

The serial number of the NFToken

ledger_hash

string

(Optional) (May be omitted) The hash of the ledger used to generate this response

ledger_index

integer

(Optional) (May be omitted) The index of the ledger used to generate this response

ledger_current_index

integer

(Optional) (May be omitted) The ledger index of the current in-progress ledger version, which was used to generate this response

status

string

The status of the request

warnings

array

(Optional) A list of warnings. 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": "account_nfts",
6
  "params": [
7
    {
8
      "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
9
      "ledger_index": "validated"
10
    }
11
  ],
12
  "id": 1
13
}'

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": "account_nfts",
6
  "params": [
7
    {
8
      "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
9
      "ledger_index": "validated"
10
    }
11
  ],
12
  "id": 1
13
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'account_nfts',
4
    params: [{"account":"rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn","ledger_index":"validated"}],
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: 'account_nfts',
4
    params: [{"account":"rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn","ledger_index":"validated"}],
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": "account_nfts",
9
  "params": [
10
    {
11
      "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
12
      "ledger_index": "validated"
13
    }
14
  ],
15
  "id": 1
16
})
17
headers = {
18
  'Content-Type': 'application/json'
19
}
20

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

23
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": "account_nfts",
9
  "params": [
10
    {
11
      "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
12
      "ledger_index": "validated"
13
    }
14
  ],
15
  "id": 1
16
})
17
headers = {
18
  'Content-Type': 'application/json'
19
}
20

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

23
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: "account_nfts",
11
  params: [{"account":"rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn","ledger_index":"validated"}]
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: "account_nfts",
11
  params: [{"account":"rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn","ledger_index":"validated"}]
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
    "ledger_hash": "FE51E76B5948B60B847B5A1ECFF57C1EAF0FACDE7E408D5A1BEB1648F0D80E96",
4
    "ledger_index": 102609803,
5
    "validated": true,
6
    "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
7
    "account_nfts": [],
8
    "limit": 100,
9
    "status": "success"
10
  },
11
  "warnings": [
12
    {
13
      "id": 2001,
14
      "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"
15
    }
16
  ]
17
}

1
{
2
  "result": {
3
    "ledger_hash": "FE51E76B5948B60B847B5A1ECFF57C1EAF0FACDE7E408D5A1BEB1648F0D80E96",
4
    "ledger_index": 102609803,
5
    "validated": true,
6
    "account": "rf1BiGeXwwQoi8Z2ueFYTEXSwuJYfV2Jpn",
7
    "account_nfts": [],
8
    "limit": 100,
9
    "status": "success"
10
  },
11
  "warnings": [
12
    {
13
      "id": 2001,
14
      "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"
15
    }
16
  ]
17
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free