Skip to main content

account_nfts

POST
Returns the list of NFTokens held by an account.It lets you check the issuer, identifier, taxon and URI of each token.
param[0]
parametersobjectrequired
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.
markerstring
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_indexoneOf
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.
The list of NFTokens held by the account.
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.
markerstring
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.
codestringrequired
Code identifying the cause of the failed request.
messagestringrequired
Detailed message including the name and value of the invalid parameter.
{
  "code": "ERROR_CODE",
  "message": "Unauthorized"
}
cURL
curl -X POST 'https://xrpl-mainnet.nodit.io' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: nodit-demo' \
  -d '{
    "method": "account_nfts",
    "params": [
      {
        "account": "r9cZA1mLK5R5Am25ArfXFmqgNwjZgnfk59",
        "limit": 100
      }
    ]
  }'