← Documentation
/ qn_fetchNFTs
AptosAptos Network's breakthrough technology and seamless user experience are now available on QuickNode.
Start building today!The API credit value for this method is 4 . To learn more about API credits and each method's value, visit the API Credits page.
Parameters:
wallet — (String) — The wallet address to check for NFTs.
omitFields - (String - optional) Optionally omit specific properties of objects from the "assets" array of the response. Any property of the asset object can be omitted. If omitFields is not included in the request, response will return all available fields by default.
page — (Integer - optional) The page number you would like returned. Page numbers start at 1 and end at "totalPages". If omitted, defaults to the first page (page 1). If the page number requested is less than 1 or higher than "totalPages", an empty assets array will be returned.
perPage — (Integer - optional) — The maximum amount of NFT assets to return on each page. You can request up to 40 items per page. If omitted, defaults to 20 items per page.
Returns:
owner - The wallet address we checked for NFTs.
assets - An array of objects representing NFTs with the following shape:
name - the name of this specific NFT.
tokenAddress - the token address of this NFT in its collection.
collectionName - the name of this NFT's collection.
imageUrl - the URL where the image for this NFT can be seen.
collectionAddress - the contract address that this NFT lives in.
traits - an array of traits that this NFT has.
creators - an array of creator addresses for this NFT token.
chain - what chain this aggregation happened on.
network - what network this aggregation happened on.
provenance - an array of transfers from previous owners for this NFT. It's important to note that this only has owners from recent blocks, for full ownership history, you'll need to enable the archive add on. This is only available for select customers at this time.
totalItems — The total number of results.
totalPages — The total number of results pages available.
pageNumber — The page number of results that was returned with this response.
Code Examples:
// not currently supported by solanaJS
const axios = require("axios");
(() => {
const config = {
headers: {
"Content-Type": "application/json",
},
};
const data = {
jsonrpc: "2.0",
id: 1,
method: "qn_fetchNFTs",
params: {
wallet: "DcTmx4VLcf5euAB17nynax7g55xuB3XKBDyz1pudMcjW",
omitFields: ["provenance", "traits"],
page: 1,
perPage: 10,
},
};
axios
.post("http://sample-endpoint-name.network.quiknode.pro/token-goes-here/", data, config)
.then(function (response) {
// handle success
console.log(response.data);
})
.catch((err) => {
// handle error
console.log(err);
});
})();
from jsonrpcclient import request, parse, Ok
import logging
import requests
response = requests.post(
"http://sample-endpoint-name.network.quiknode.pro/token-goes-here/",
json=request("qn_fetchNFTs", {
"wallet": "DcTmx4VLcf5euAB17nynax7g55xuB3XKBDyz1pudMcjW",
"omitFields": [
"provenance",
"traits"
],
"page": 1,
"perPage": 10
})
)
parsed = parse(response.json())
if isinstance(parsed, Ok):
print(parsed.result)
else:
logging.error(parsed.message)
curl -X "POST" "http://sample-endpoint-name.network.quiknode.pro/token-goes-here/" \
-H 'Content-Type: application/json' \
--data '{
"id":67,
"jsonrpc":"2.0",
"method":"qn_fetchNFTs",
"params":{
"wallet": "DcTmx4VLcf5euAB17nynax7g55xuB3XKBDyz1pudMcjW",
"omitFields": [
"provenance",
"traits"
],
"page": 1,
"perPage": 10
}
}'