Console

POSTaccount_nfts

XRP Ledger Mainnethttps://xrpl-mainnet.nodit.io/

Returns the list of NFTokens held by an account. It lets you check the issuer, identifier, taxon and URI of each token.

Request Body
methodstringrequired
accountstringrequired

The address of the account that owns the NFTokens.

limitinteger

The number of token pages to return. Pass a value between 20 and 400.

markerobject

A value that marks a pagination position. Pass the marker value from a previous response to retrieve the next page. Its format depends on the server implementation, so use it verbatim without interpreting its contents.

ledger_hashstring

The hash of the ledger version to use. Pass a 32-byte hex string.

ledger_indexinteger

Specifies the ledger version to use. Pass a ledger index as an integer, or use one of the shortcut strings below.

  • validated: Uses the most recent ledger version validated by the network.
  • closed: Uses the most recent ledger version the server has closed. It may not be validated.
  • current: Uses the in-progress ledger version the server is currently building.

The ledger index of the version to use.

Responses
accountstring

The address of the account that owns the NFTokens.

Flagsinteger

A bit-map of boolean flags enabled for the NFToken.

Issuerstring

The address of the account that issued the NFToken.

NFTokenIDstring

The hex string that identifies the NFToken.

NFTokenTaxoninteger

The taxon assigned by the issuer. Tokens sharing a taxon may belong to the same series.

URIstring

The URI of the NFToken, hex-encoded.

nft_serialinteger

The serial number of the NFToken, unique to its issuer.

limitinteger

The limit value used in the request.

markerobject

A value that marks a pagination position. Pass the marker value from a previous response to retrieve the next page. Its format depends on the server implementation, so use it verbatim without interpreting its contents.

ledger_hashstring

The hash of the ledger version used. Returned when a validated ledger version was queried.

ledger_indexinteger

The ledger index of the version used. Returned when a validated ledger version was queried.

ledger_current_indexinteger

The ledger index of the in-progress ledger. Returned when the current ledger was queried.

validatedboolean

Whether the response was derived from a validated ledger version.

X-API-KEY
RequestCU50
cURL
curl -X POST "https://xrpl-mainnet.nodit.io/" \
  -H "X-API-KEY: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "method": "account_nfts",
  "params": [
    {
      "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
      "ledger_index": "validated",
      "limit": 100
    }
  ]
}'
Response
Example · 200
{
  "result": {
    "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
    "account_nfts": [
      {
        "Flags": 8,
        "Issuer": "rMwjYedjc7qqtKYVLiAccJSmCwih4LnE2q",
        "NFTokenID": "000800006203F49C21D5D6E022CB16DE3538F248662FC73C00000E39",
        "NFTokenTaxon": 0,
        "URI": "697066733A2F2F62616679626569676479727A",
        "nft_serial": 3641
      }
    ],
    "ledger_hash": "17ACB57A0F73B5160713E81FE72B2AC9F6064541004E272BD09F257D57C30C02",
    "ledger_index": 98765432,
    "validated": true
  }
}

Last updated