account_nfts

​

Reference: Here

​

Parameters

• account (string, required) The address of the account. The request returns a list of NFTs owned by this account.
• ledger_hash (string, optional) The unique hash of the ledger version to use.
• ledger_index (number or string, optional) The ledger index of the ledger to use, or a shortcut string such as validated, closed or current.
• limit (integer, optional) Limit the number of token pages to retrieve. Each page can contain up to 32 NFTs. Cannot be lower than 20 or more than 400. The default is 100.
• marker (marker, optional) Value from a previous paginated response. Resume retrieving data where that response left off.

​

Returns

• account (string) The account that owns the list of NFTs.
• account_nfts (array) A list of NFTs owned by the account. Each NFT object has Flags, Issuer, NFTokenID, NFTokenTaxon, URI, nft_serial and, if set, TransferFee.
• ledger_hash (string) The identifying hash of the ledger used to generate this response.
• ledger_index (number) The ledger index of the ledger used to generate this response.
• ledger_current_index (number) The ledger index of the current in-progress ledger, if used.
• validated (boolean) If true, the information comes from a validated ledger version.
• marker (marker) Server-defined value indicating the response is paginated. Omitted when there are no additional pages.

// Result
{
  "result": {
    "ledger_hash": "6956776EA47C5A8F6253D5FD540C5982071E05928C52AC4F8DDF36A95F7BD20E",
    "ledger_index": 107293004,
    "validated": true,
    "account": "rGNtXLja1ZJk2Kcum2wDdvaAk12pXHCcro",
    "account_nfts": [
      {
        "NFTokenID": "00081B58618112438BDB92AB281F76CBAFA853CCC0F7BC6079AB5DD6064E6D37",
        "URI": "697066733A2F2F6261667962656962743667746E...",
        "Flags": 8,
        "Issuer": "r9tZweDCL294wC6gVSunNKQTQMTXcYHzvj",
        "NFTokenTaxon": 4,
        "nft_serial": 105803063,
        "TransferFee": 7000
      },
      // ...
    ],
    "limit": 20,
    "status": "success"
  }
}

curl https://mainnet.xrpl.validationcloud.io/v1/<YOUR_API_KEY_HERE> \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{"method":"account_nfts","params":[{"account":"rGNtXLja1ZJk2Kcum2wDdvaAk12pXHCcro","ledger_index":"validated","limit":20}]}'