GET /nft
GET

/v1/nft

List NFTs

AuthNone — works without a key

Request

GEThttps://api.xrpl.to/v1/nft
Query parameterValueDescription
cidcollection id
issueraddress
taxonint (NFTokenTaxon; requires issuer)
offsetint (>=0)
limitint (max 200, default 20; response echoes effective limit)
sortcreated|time|rarity_rank|volume|cost.amount
orderasc|desc
curl 'https://api.xrpl.to/v1/nft'

Response

200Example response3 ms · just now · 15 KB · 495 lines
https://api.xrpl.to/v1/nft
{
  "success": true,
  "nfts": [
    {
      "_id": "00181388F1F5584F5630E36D1FCE776B38684142E8FB74B6CA4AEA270652368A",
      "NFTokenID": "00181388F1F5584F5630E36D1FCE776B38684142E8FB74B6CA4AEA270652368A",
      "account": "rKqqb5QZXVAL3VqXJL6obfRGeHou1DtyBV",
      "issuer": "rPhMmag9YDcw9d5izQaFRRLfU7EB7WNQky",
      "taxon": 2,
      "royalty": 5000,
      "flag": 24,
      "URI": "697066733A2F2F62616679626569626A33716F357270696A7977776F336C7874667876787065646B68656E3571787476756F6F3362666970356865357579737669792F3236312E6A736F6E",
      "volume": 0,
      "hash": "451DAFB0561888436826487C1EEC68E5F210C7C5C42D4D0D4835385C1EEBE847",
      "time": 1791767031000,
      "created": 1791767031000,
      "ledger_index": 107595340,
      "LedgerSequence": 45,
      "MasterSequence": 23266648,
      "TicketSequence": 88947523,
      "SourceTag": 101102979,
      "cid": "7cdd69ad51f449c78dfe83eab178fdc0",
      "collection": "Punx Revolution",
      "cslug": "punx-revolution",
      "name": "Punx #261",
      "props": [
        {
          "type": "Background",
          "value": "Spotlight Stone",
          "count": 22
        },
        {
          "type": "Right Wall",
          "value": "Evil Basketball Hoop",
          "count": 12
        },
        {
          "type": "Air Drops - Punx",
          "value": "None",
          "count": 605
        },
        {
          "type": "Left Wall",
          "value": "Paracelsus Trident",
          "count": 12
        },
        {
          "type": "Pets",
          "value": "Scruffy Dog",
          "count": 14
        }
      ],
      "total": 611,
      "meta": {
        "schema": "ipfs://QmNpi8rcXEkohca8iXu7zysKKSJYqCvBJn3xJwXdbQCcD3",
        "nftType": "art.v0",
        "name": "Punx #261",
        "description": "",
        "image": "ipfs://bafybeibi7pusvoibzr7fizmk5n4x5v5esefgmde3hpyd2sbusy355du47a/261.png",
        "animation": "",
        "video": "",
        "audio": "",
        "file": "",
        "collection": {
          "name": "Punx",
          "family": ""
        },
        "attributes": [
          {
            "trait_type": "Background",
            "value": "Spotlight Stone"
          },
          {
            "trait_type": "Right Wall",
            "value": "Evil Basketball Hoop"
          },
          {
            "trait_type": "Air Drops - Punx",
            "value": "None"
          },
          {
            "trait_type": "Left Wall",
            "value": "Paracelsus Trident"
          },
          {
            "trait_type": "Pets",
            "value": "Scruffy Dog"
          }
        ],
        "nfttype": "art.v0"
      },
      "url": "ipfs://bafybeibj3qo5rpijywwo3lxtfxvxpedkhen5qxtvuoo3bfip5he5uysviy/261.json",
      "files": [
        {
          "isIPFS": true,
          "type": "image",
          "parsedType": "image",
          "parsedUrl": "ipfs://bafybeibi7pusvoibzr7fizmk5n4x5v5esefgmde3hpyd2sbusy355du47a/261.png",
          "IPFSPath": "bafybeibi7pusvoibzr7fizmk5n4x5v5esefgmde3hpyd2sbusy355du47a/261.png",
          "thumbnail": {
            "small": "5cf58bdbc057f0fd92770c359e115029s",
            "medium": "5cf58bdbc057f0fd92770c359e115029m",
            "large": "5cf58bdbc057f0fd92770c359e115029l"
          }
        }
      ],
      "memo": "Punx Revolution NFT Mint by xrp.cafe",
      "origin": "xrp.cafe",
      "cost": null,
      "updateEvent": "MINT"
    },
    {
      "_id": "00181388F1F5584F5630E36D1FCE776B38684142E8FB74B6B365192606523689",
      "NFTokenID": "00181388F1F5584F5630E36D1FCE776B38684142E8FB74B6B365192606523689",
      "account": "rKqqb5QZXVAL3VqXJL6obfRGeHou1DtyBV",
      "issuer": "rPhMmag9YDcw9d5izQaFRRLfU7EB7WNQky",
      "taxon": 2,
      "royalty": 5000,
      "flag": 24,
      "URI": "697066733A2F2F62616679626569626A33716F357270696A7977776F336C7874667876787065646B68656E3571787476756F6F3362666970356865357579737669792F3734342E6A736F6E",
      "volume": 0,
      "hash": "E999193289487B0C494BE323BFC0589F7F99E7E0969CE41F2830B3A995CCD43F",
      "time": 1791767031000,
      "created": 1791767031000,
      "ledger_index": 107595340,
      "LedgerSequence": 44,
      "MasterSequence": 23266647,
      "TicketSequence": 88947516,
      "SourceTag": 101102979,
      "cid": "7cdd69ad51f449c78dfe83eab178fdc0",
      "collection": "Punx Revolution",
      "cslug": "punx-revolution",
      "name": "Punx #744",
      "props": [],
      "total": 611,
      "meta": {
        "schema": "ipfs://QmNpi8rcXEkohca8iXu7zysKKSJYqCvBJn3xJwXdbQCcD3",
        "nftType": "art.v0",
        "name": "Punx #744",
        "description": "",
        "image": "ipfs://bafybeibi7pusvoibzr7fizmk5n4x5v5esefgmde3hpyd2sbusy355du47a/744.png",
        "animation": "",
        "video": "",
        "audio": "",
        "file": "",
        "collection": {
          "name": "Punx",
          "family": ""
        },
        "attributes": [
          {
            "trait_type": "Background",
            "value": "Beige Flagstone"
          },
          {
            "trait_type": "Right Wall",
            "value": "None"
          },
          {
            "trait_type": "Air Drops - Punx",
            "value": "None"
          },
          {
            "trait_type": "Left Wall",
            "value": "DMT Molecule"
          },
          {
            "trait_type": "Pets",
            "value": "Punk Iguana"
          }
        ],
        "nfttype": "art.v0"
      },
      "url": "ipfs://bafybeibj3qo5rpijywwo3lxtfxvxpedkhen5qxtvuoo3bfip5he5uysviy/744.json",
      "files": [
        {
          "isIPFS": true,
          "type": "image",
          "parsedType": "image",
          "parsedUrl": "ipfs://bafybeibi7pusvoibzr7fizmk5n4x5v5esefgmde3hpyd2sbusy355du47a/744.png",
          "IPFSPath": "bafybeibi7pusvoibzr7fizmk5n4x5v5esefgmde3hpyd2sbusy355du47a/744.png",
          "thumbnail": {
            "small": "b49952473cc3c952e54745d54e7bee6as",
            "medium": "b49952473cc3c952e54745d54e7bee6am",
            "large": "b49952473cc3c952e54745d54e7bee6al"
          }
        }
      ],
      "memo": "Punx Revolution NFT Mint by xrp.cafe",
      "origin": "xrp.cafe",
      "cost": null,
      "updateEvent": "MINT"
    },
    {
      "_id": "00181388F1F5584F5630E36D1FCE776B38684142E8FB74B69C7F482106523688",
      "NFTokenID": "00181388F1F5584F5630E36D1FCE776B38684142E8FB74B69C7F482106523688",
      "account": "rKqqb5QZXVAL3VqXJL6obfRGeHou1DtyBV",
      "issuer": "rPhMmag9YDcw9d5izQaFRRLfU7EB7WNQky",
      "taxon": 2,
      "royalty": 5000,
      "flag": 24,
      "URI": "697066733A2F2F62616679626569626A33716F357270696A7977776F336C7874667876787065646B68656E3571787476756F6F3362666970356865357579737669792F3135302E6A736F6E",
      "volume": 0,
      "hash": "A799119AF3D3E47EB6470714AB7CD80A6931D37C0C93EE44526B9C684EC139C5",
      "time": 1791767031000,
      "created": 1791767031000,
      "ledger_index": 107595340,
      "LedgerSequence": 43,
      "MasterSequence": 23266646,
      "TicketSequence": 88947514,
      "SourceTag": 101102979,
      "cid": "7cdd69ad51f449c78dfe83eab178fdc0",
      "collection": "Punx Revolution",
      "cslug": "punx-revolution",
      "name": "Punx #150",
      "props": [],
      "total": 611,
      "meta": {
        "schema": "ipfs://QmNpi8rcXEkohca8iXu7zysKKSJYqCvBJn3xJwXdbQCcD3",
        "nftType": "art.v0",
        "name": "Punx #150",
        "description": "",
        "image": "ipfs://bafybeibi7pusvoibzr7fizmk5n4x5v5esefgmde3hpyd2sbusy355du47a/150.png",
        "animation": "",
        "video": "",
        "audio": "",
        "file": "",
        "collection": {
          "name": "Punx",
          "family": ""
        },
        "attributes": [
          {
            "trait_type": "Background",
            "value": "Dark Brick"
          },
          {
            "trait_type": "Right Wall",
            "value": "Spirit Chart Parchment"
          },
          {
            "trait_type": "Air Drops - Punx",
            "value": "None"
          },
          {
            "trait_type": "Left Wall",
            "value": "Evil Punx"
          },
          {
            "trait_type": "Pets",
            "value": "Punk Iguana"
          }
        ],
        "nfttype": "art.v0"
      },
      "url": "ipfs://bafybeibj3qo5rpijywwo3lxtfxvxpedkhen5qxtvuoo3bfip5he5uysviy/150.json",
      "files": [
        {
          "isIPFS": true,
          "type": "image",
          "parsedType": "image",
          "parsedUrl": "ipfs://bafybeibi7pusvoibzr7fizmk5n4x5v5esefgmde3hpyd2sbusy355du47a/150.png",
          "IPFSPath": "bafybeibi7pusvoibzr7fizmk5n4x5v5esefgmde3hpyd2sbusy355du47a/150.png",
          "thumbnail": {
            "small": "8de2cafac799654a3a3c017e7a7db82as",
            "medium": "8de2cafac799654a3a3c017e7a7db82am",
            "large": "8de2cafac799654a3a3c017e7a7db82al"
          }
        }
      ],
      "memo": "Punx Revolution NFT Mint by xrp.cafe",
      "origin": "xrp.cafe",
      "cost": null,
      "updateEvent": "MINT"
    },
    {
      "_id": "00181388F1F5584F5630E36D1FCE776B38684142E8FB74B68599772006523687",
      "NFTokenID": "00181388F1F5584F5630E36D1FCE776B38684142E8FB74B68599772006523687",
      "account": "rKqqb5QZXVAL3VqXJL6obfRGeHou1DtyBV",
      "issuer": "rPhMmag9YDcw9d5izQaFRRLfU7EB7WNQky",
      "taxon": 2,
      "royalty": 5000,
      "flag": 24,
      "URI": "697066733A2F2F62616679626569626A33716F357270696A7977776F336C7874667876787065646B68656E3571787476756F6F3362666970356865357579737669792F313038382E6A736F6E",
      "volume": 0,
      "hash": "50F41AC8D4EEC1E818D2D0F7AF485C1D50627625C9A17DBEAB38E8A3EFE7C474",
      "time": 1791767031000,
      "created": 1791767031000,
      "ledger_index": 107595340,
      "LedgerSequence": 42,
      "MasterSequence": 23266645,
      "TicketSequence": 88947512,
      "SourceTag": 101102979,
      "cid": "7cdd69ad51f449c78dfe83eab178fdc0",
      "collection": "Punx Revolution",
      "cslug": "punx-revolution",
      "name": "Punx #1088",
      "props": [
        {
          "type": "Background",
          "value": "Checkerboard",
          "count": 38
        },
        {
          "type": "Right Wall",
          "value": "Punx Strikes Back Poster",
          "count": 13
        },
        {
          "type": "Air Drops - Punx",
          "value": "None",
          "count": 605
        },
        {
          "type": "Left Wall",
          "value": "Sacred Geometry",
          "count": 10
        },
        {
          "type": "Pets",
          "value": "Evil Potted Plant",
          "count": 7
        }
      ],
      "total": 611,
      "meta": {
        "schema": "ipfs://QmNpi8rcXEkohca8iXu7zysKKSJYqCvBJn3xJwXdbQCcD3",
        "nftType": "art.v0",
        "name": "Punx #1088",
        "description": "",
        "image": "ipfs://bafybeibi7pusvoibzr7fizmk5n4x5v5esefgmde3hpyd2sbusy355du47a/1088.png",
        "animation": "",
        "video": "",
        "audio": "",
        "file": "",
        "collection": {
          "name": "Punx",
          "family": ""
        },
        "attributes": [
          {
            "trait_type": "Background",
            "value": "Checkerboard"
          },
          {
            "trait_type": "Right Wall",
            "value": "Punx Strikes Back Poster"
          },
          {
            "trait_type": "Air Drops - Punx",
            "value": "None"
          },
          {
            "trait_type": "Left Wall",
            "value": "Sacred Geometry"
          },
          {
            "trait_type": "Pets",
            "value": "Evil Potted Plant"
          }
        ],
        "nfttype": "art.v0"
      },
      "url": "ipfs://bafybeibj3qo5rpijywwo3lxtfxvxpedkhen5qxtvuoo3bfip5he5uysviy/1088.json",
      "files": [
        {
          "isIPFS": true,
          "type": "image",
          "parsedType": "image",
          "parsedUrl": "ipfs://bafybeibi7pusvoibzr7fizmk5n4x5v5esefgmde3hpyd2sbusy355du47a/1088.png",
          "IPFSPath": "bafybeibi7pusvoibzr7fizmk5n4x5v5esefgmde3hpyd2sbusy355du47a/1088.png",
          "thumbnail": {
            "small": "20050c7d3fee9db28eb90d90157e3755s",
            "medium": "20050c7d3fee9db28eb90d90157e3755m",
            "large": "20050c7d3fee9db28eb90d90157e3755l"
          }
        }
      ],
      "memo": "Punx Revolution NFT Mint by xrp.cafe",
      "origin": "xrp.cafe",
      "cost": null,
      "updateEvent": "MINT"
    },
    {
      "_id": "00181388F1F5584F5630E36D1FCE776B38684142E8FB74B66EB3A62306523686",
      "NFTokenID": "00181388F1F5584F5630E36D1FCE776B38684142E8FB74B66EB3A62306523686",
      "account": "rKqqb5QZXVAL3VqXJL6obfRGeHou1DtyBV",
      "issuer": "rPhMmag9YDcw9d5izQaFRRLfU7EB7WNQky",
      "taxon": 2,
      "royalty": 5000,
      "flag": 24,
      "URI": "697066733A2F2F62616679626569626A33716F357270696A7977776F336C7874667876787065646B68656E3571787476756F6F3362666970356865357579737669792F3834302E6A736F6E",
      "volume": 0,
      "hash": "65EAAE348C64B2707F8802B4A1812024A5AB35EB9168DF1C8711C1D26A132B3D",
      "time": 1791767031000,
      "created": 1791767031000,
      "ledger_index": 107595340,
      "LedgerSequence": 41,
      "MasterSequence": 23266644,
      "TicketSequence": 88947497,
      "SourceTag": 101102979,
      "cid": "7cdd69ad51f449c78dfe83eab178fdc0",
      "collection": "Punx Revolution",
      "cslug": "punx-revolution",
      "name": "Punx #840",
      "props": [
        {
          "type": "Background",
          "value": "White Brick",
          "count": 33
        },
        {
          "type": "Right Wall",
          "value": "None",
          "count": 314
        },
        {
          "type": "Air Drops - Punx",
          "value": "None",
          "count": 605
        },
        {
          "type": "Left Wall",
          "value": "Smoking Plant",
          "count": 6
        },
        {
          "type": "Pets",
          "value": "Punk Iguana",
          "count": 10
        }
      ],
      "total": 611,
      "meta": {
        "schema": "ipfs://QmNpi8rcXEkohca8iXu7zysKKSJYqCvBJn3xJwXdbQCcD3",
        "nftType": "art.v0",
        "name": "Punx #840",
        "description": "",
        "image": "ipfs://bafybeibi7pusvoibzr7fizmk5n4x5v5esefgmde3hpyd2sbusy355du47a/840.png",
        "animation": "",
        "video": "",
        "audio": "",
        "file": "",
        "collection": {
          "name": "Punx",
          "family": ""
        },
        "attributes": [
          {
            "trait_type": "Background",
            "value": "White Brick"
          },
          {
            "trait_type": "Right Wall",
            "value": "None"
          },
          {
            "trait_type": "Air Drops - Punx",
            "value": "None"
          },
          {
            "trait_type": "Left Wall",
            "value": "Smoking Plant"
          },
          {
            "trait_type": "Pets",
            "value": "Punk Iguana"
          }
        ],
        "nfttype": "art.v0"
      },
      "url": "ipfs://bafybeibj3qo5rpijywwo3lxtfxvxpedkhen5qxtvuoo3bfip5he5uysviy/840.json",
      "files": [
        {
          "isIPFS": true,
          "type": "image",
          "parsedType": "image",
          "parsedUrl": "ipfs://bafybeibi7pusvoibzr7fizmk5n4x5v5esefgmde3hpyd2sbusy355du47a/840.png",
          "IPFSPath": "bafybeibi7pusvoibzr7fizmk5n4x5v5esefgmde3hpyd2sbusy355du47a/840.png",
          "thumbnail": {
            "small": "8b2a6e4f0529c5d1db2dc44a1ecf8d10s",
            "medium": "8b2a6e4f0529c5d1db2dc44a1ecf8d10m",
            "large": "8b2a6e4f0529c5d1db2dc44a1ecf8d10l"
          }
        }
      ],
      "memo": "Punx Revolution NFT Mint by xrp.cafe",
      "origin": "xrp.cafe",
      "cost": null,
      "updateEvent": "MINT"
    }
  ],
  "offset": 0,
  "limit": 20
}

Long arrays and strings are shortened in the example; Send request for the full answer.

What it does

List NFTs

A collection is its slug, or its on-chain identity as issuer:taxon. Each NFT in it comes back with its NFTokenID, the id every NFT endpoint takes. Go to NFT →
OpenAPI