getNFTs API

Parameters

  • owner: address for NFT owner
  • offset: offset from which to return NFTs (defaults to 0)
  • limit: number of NFTs returned in each request (defaults to 25)
  • contractAddresses[]: filter for contract address (must always be specified with contractNames[]
  • contractNames[]: filter for contract name (must always be specified with contractAddresses[]

Returns

  • ownerAddress: address for NFT owner
  • nfts: List of NFTs owned by the ownerAddress. It includes
    • contract: Contract name, address, external domain and metadata
    • id: NFT ID and UUID
    • title: NFT Title
    • description: NFT description
    • media: Media url for the NFT
    • metadata: Metadata for the NFT
  • nftcount: total NFTs owned by the ownerAddress

Example

Here is an example request to query all the NFTs owned by 0x9eef2e4511390ce4.

Request

curl https://flow-mainnet.g.alchemy.com/v2/<your-api-key>/getNFTs/?owner=0x9eef2e4511390ce4&offset=0&limit=10

Response

{
"ownerAddress":"0x9eef2e4511390ce4",
"nfts":[
{
"contract":{
"name":"Gaia",
"address":"0x8b148183c28ff88f",
"externalDomain":"ballerz.xyz",
"contractMetadata":{
"storagePath":"Gaia.CollectionStoragePath",
"publicPath":"Gaia.CollectionPublicPath",
"publicCollectionName":"Gaia.CollectionPublic"
}
},
"id":{
"tokenId":"13348",
"tokenMetadata":{
"uuid":"83699066"
}
},
"title":"Bryson DeChambeau - Vegas, Baby!",
"description":"Commemorating Bryson DeChambeau’s November 26, 2021 event in Las Vegas, NV",
"media":{
"uri":"ipfs://QmScvqCQ8PouGdPECBbE9DznAAZaTYT7ekkbyNkKYhTq3W",
"mimeType":"image"
},
"metadata":{
"metadata":[
{
"name":"item",
"value":"1"
},
{
"name":"editions",
"value":"5000"
},
{
"name":"location",
"value":"Las Vegas, NV"
},
{
"name":"video",
"value":"ipfs://QmS5UE3fAYSgpsAXgS6wAqAJc2v7gRxN6QFLxZ92FNZ1Y6"
},
{
"name":"description",
"value":"Commemorating Bryson DeChambeau’s November 26, 2021 event in Las Vegas, NV"
},
{
"name":"series",
"value":"Bryson DeChambeau - Vegas, Baby!"
},
{
"name":"type",
"value":"Golf"
},
{
"name":"img",
"value":"ipfs://QmScvqCQ8PouGdPECBbE9DznAAZaTYT7ekkbyNkKYhTq3W"
},
{
"name":"title",
"value":"Bryson DeChambeau - Vegas, Baby!"
}
]
}
},
{
"contract":{
"name":"Gaia",
"address":"0x8b148183c28ff88f",
"externalDomain":"ballerz.xyz",
"contractMetadata":{
"storagePath":"Gaia.CollectionStoragePath",
"publicPath":"Gaia.CollectionPublicPath",
"publicCollectionName":"Gaia.CollectionPublic"
}
},
"id":{
"tokenId":"14379",
"tokenMetadata":{
"uuid":"84080071"
}
},
"title":"Bryson DeChambeau - Vegas, Baby!",
"description":"Commemorating Bryson DeChambeau’s November 26, 2021 event in Las Vegas, NV",
"media":{
"uri":"ipfs://QmScvqCQ8PouGdPECBbE9DznAAZaTYT7ekkbyNkKYhTq3W",
"mimeType":"image"
},
"metadata":{
"metadata":[
{
"name":"item",
"value":"1"
},
{
"name":"editions",
"value":"5000"
},
{
"name":"location",
"value":"Las Vegas, NV"
},
{
"name":"video",
"value":"ipfs://QmS5UE3fAYSgpsAXgS6wAqAJc2v7gRxN6QFLxZ92FNZ1Y6"
},
{
"name":"description",
"value":"Commemorating Bryson DeChambeau’s November 26, 2021 event in Las Vegas, NV"
},
{
"name":"series",
"value":"Bryson DeChambeau - Vegas, Baby!"
},
{
"name":"type",
"value":"Golf"
},
{
"name":"img",
"value":"ipfs://QmScvqCQ8PouGdPECBbE9DznAAZaTYT7ekkbyNkKYhTq3W"
},
{
"name":"title",
"value":"Bryson DeChambeau - Vegas, Baby!"
}
]
}
},
{
"contract":{
"name":"Gaia",
"address":"0x8b148183c28ff88f",
"externalDomain":"ballerz.xyz",
"contractMetadata":{
"storagePath":"Gaia.CollectionStoragePath",
"publicPath":"Gaia.CollectionPublicPath",
"publicCollectionName":"Gaia.CollectionPublic"
}
},
"id":{
"tokenId":"14518",
"tokenMetadata":{
"uuid":"84092375"
}
},
"title":"Bryson DeChambeau - Vegas, Baby!",
"description":"Commemorating Bryson DeChambeau’s November 26, 2021 event in Las Vegas, NV",
"media":{
"uri":"ipfs://QmScvqCQ8PouGdPECBbE9DznAAZaTYT7ekkbyNkKYhTq3W",
"mimeType":"image"
},
"metadata":{
"metadata":[
{
"name":"item",
"value":"1"
},
{
"name":"editions",
"value":"5000"
},
{
"name":"location",
"value":"Las Vegas, NV"
},
{
"name":"video",
"value":"ipfs://QmS5UE3fAYSgpsAXgS6wAqAJc2v7gRxN6QFLxZ92FNZ1Y6"
},
{
"name":"description",
"value":"Commemorating Bryson DeChambeau’s November 26, 2021 event in Las Vegas, NV"
},
{
"name":"series",
"value":"Bryson DeChambeau - Vegas, Baby!"
},
{
"name":"type",
"value":"Golf"
},
{
"name":"img",
"value":"ipfs://QmScvqCQ8PouGdPECBbE9DznAAZaTYT7ekkbyNkKYhTq3W"
},
{
"name":"title",
"value":"Bryson DeChambeau - Vegas, Baby!"
}
]
}
},
{
"contract":{
"name":"Gaia",
"address":"0x8b148183c28ff88f",
"externalDomain":"ballerz.xyz",
"contractMetadata":{
"storagePath":"Gaia.CollectionStoragePath",
"publicPath":"Gaia.CollectionPublicPath",
"publicCollectionName":"Gaia.CollectionPublic"
}
},
"id":{
"tokenId":"10524",
"tokenMetadata":{
"uuid":"83528145"
}
},
"title":"Bryson DeChambeau - Vegas, Baby!",
"description":"Commemorating Bryson DeChambeau’s November 26, 2021 event in Las Vegas, NV",
"media":{
"uri":"ipfs://QmScvqCQ8PouGdPECBbE9DznAAZaTYT7ekkbyNkKYhTq3W",
"mimeType":"image"
},
"metadata":{
"metadata":[
{
"name":"item",
"value":"1"
},
{
"name":"editions",
"value":"5000"
},
{
"name":"location",
"value":"Las Vegas, NV"
},
{
"name":"video",
"value":"ipfs://QmS5UE3fAYSgpsAXgS6wAqAJc2v7gRxN6QFLxZ92FNZ1Y6"
},
{
"name":"description",
"value":"Commemorating Bryson DeChambeau’s November 26, 2021 event in Las Vegas, NV"
},
{
"name":"series",
"value":"Bryson DeChambeau - Vegas, Baby!"
},
{
"name":"type",
"value":"Golf"
},
{
"name":"img",
"value":"ipfs://QmScvqCQ8PouGdPECBbE9DznAAZaTYT7ekkbyNkKYhTq3W"
},
{
"name":"title",
"value":"Bryson DeChambeau - Vegas, Baby!"
}
]
}
},
{
"contract":{
"name":"Gaia",
"address":"0x8b148183c28ff88f",
"externalDomain":"ballerz.xyz",
"contractMetadata":{
"storagePath":"Gaia.CollectionStoragePath",
"publicPath":"Gaia.CollectionPublicPath",
"publicCollectionName":"Gaia.CollectionPublic"
}
},
"id":{
"tokenId":"13744",
"tokenMetadata":{
"uuid":"83716052"
}
},
"title":"Bryson DeChambeau - Vegas, Baby!",
"description":"Commemorating Bryson DeChambeau’s November 26, 2021 event in Las Vegas, NV",
"media":{
"uri":"ipfs://QmScvqCQ8PouGdPECBbE9DznAAZaTYT7ekkbyNkKYhTq3W",
"mimeType":"image"
},
"metadata":{
"metadata":[
{
"name":"item",
"value":"1"
},
{
"name":"editions",
"value":"5000"
},
{
"name":"location",
"value":"Las Vegas, NV"
},
{
"name":"video",
"value":"ipfs://QmS5UE3fAYSgpsAXgS6wAqAJc2v7gRxN6QFLxZ92FNZ1Y6"
},
{
"name":"description",
"value":"Commemorating Bryson DeChambeau’s November 26, 2021 event in Las Vegas, NV"
},
{
"name":"series",
"value":"Bryson DeChambeau - Vegas, Baby!"
},
{
"name":"type",
"value":"Golf"
},
{
"name":"img",
"value":"ipfs://QmScvqCQ8PouGdPECBbE9DznAAZaTYT7ekkbyNkKYhTq3W"
},
{
"name":"title",
"value":"Bryson DeChambeau - Vegas, Baby!"
}
]
}
},
{
"contract":{
"name":"Gaia",
"address":"0x8b148183c28ff88f",
"externalDomain":"ballerz.xyz",
"contractMetadata":{
"storagePath":"Gaia.CollectionStoragePath",
"publicPath":"Gaia.CollectionPublicPath",
"publicCollectionName":"Gaia.CollectionPublic"
}
},
"id":{
"tokenId":"13870",
"tokenMetadata":{
"uuid":"84015816"
}
},
"title":"Bryson DeChambeau - Vegas, Baby!",
"description":"Commemorating Bryson DeChambeau’s November 26, 2021 event in Las Vegas, NV",
"media":{
"uri":"ipfs://QmScvqCQ8PouGdPECBbE9DznAAZaTYT7ekkbyNkKYhTq3W",
"mimeType":"image"
},
"metadata":{
"metadata":[
{
"name":"item",
"value":"1"
},
{
"name":"editions",
"value":"5000"
},
{
"name":"location",
"value":"Las Vegas, NV"
},
{
"name":"video",
"value":"ipfs://QmS5UE3fAYSgpsAXgS6wAqAJc2v7gRxN6QFLxZ92FNZ1Y6"
},
{
"name":"description",
"value":"Commemorating Bryson DeChambeau’s November 26, 2021 event in Las Vegas, NV"
},
{
"name":"series",
"value":"Bryson DeChambeau - Vegas, Baby!"
},
{
"name":"type",
"value":"Golf"
},
{
"name":"img",
"value":"ipfs://QmScvqCQ8PouGdPECBbE9DznAAZaTYT7ekkbyNkKYhTq3W"
},
{
"name":"title",
"value":"Bryson DeChambeau - Vegas, Baby!"
}
]
}
},
{
"contract":{
"name":"Gaia",
"address":"0x8b148183c28ff88f",
"externalDomain":"ballerz.xyz",
"contractMetadata":{
"storagePath":"Gaia.CollectionStoragePath",
"publicPath":"Gaia.CollectionPublicPath",
"publicCollectionName":"Gaia.CollectionPublic"
}
},
"id":{
"tokenId":"13335",
"tokenMetadata":{
"uuid":"83699053"
}
},
"title":"Bryson DeChambeau - Vegas, Baby!",
"description":"Commemorating Bryson DeChambeau’s November 26, 2021 event in Las Vegas, NV",
"media":{
"uri":"ipfs://QmScvqCQ8PouGdPECBbE9DznAAZaTYT7ekkbyNkKYhTq3W",
"mimeType":"image"
},
"metadata":{
"metadata":[
{
"name":"item",
"value":"1"
},
{
"name":"editions",
"value":"5000"
},
{
"name":"location",
"value":"Las Vegas, NV"
},
{
"name":"video",
"value":"ipfs://QmS5UE3fAYSgpsAXgS6wAqAJc2v7gRxN6QFLxZ92FNZ1Y6"
},
{
"name":"description",
"value":"Commemorating Bryson DeChambeau’s November 26, 2021 event in Las Vegas, NV"
},
{
"name":"series",
"value":"Bryson DeChambeau - Vegas, Baby!"
},
{
"name":"type",
"value":"Golf"
},
{
"name":"img",
"value":"ipfs://QmScvqCQ8PouGdPECBbE9DznAAZaTYT7ekkbyNkKYhTq3W"
},
{
"name":"title",
"value":"Bryson DeChambeau - Vegas, Baby!"
}
]
}
},
{
"contract":{
"name":"Gaia",
"address":"0x8b148183c28ff88f",
"externalDomain":"ballerz.xyz",
"contractMetadata":{
"storagePath":"Gaia.CollectionStoragePath",
"publicPath":"Gaia.CollectionPublicPath",
"publicCollectionName":"Gaia.CollectionPublic"
}
},
"id":{
"tokenId":"14755",
"tokenMetadata":{
"uuid":"84108967"
}
},
"title":"Bryson DeChambeau - Vegas, Baby!",
"description":"Commemorating Bryson DeChambeau’s November 26, 2021 event in Las Vegas, NV",
"media":{
"uri":"ipfs://QmScvqCQ8PouGdPECBbE9DznAAZaTYT7ekkbyNkKYhTq3W",
"mimeType":"image"
},
"metadata":{
"metadata":[
{
"name":"item",
"value":"1"
},
{
"name":"editions",
"value":"5000"
},
{
"name":"location",
"value":"Las Vegas, NV"
},
{
"name":"video",
"value":"ipfs://QmS5UE3fAYSgpsAXgS6wAqAJc2v7gRxN6QFLxZ92FNZ1Y6"
},
{
"name":"description",
"value":"Commemorating Bryson DeChambeau’s November 26, 2021 event in Las Vegas, NV"
},
{
"name":"series",
"value":"Bryson DeChambeau - Vegas, Baby!"
},
{
"name":"type",
"value":"Golf"
},
{
"name":"img",
"value":"ipfs://QmScvqCQ8PouGdPECBbE9DznAAZaTYT7ekkbyNkKYhTq3W"
},
{
"name":"title",
"value":"Bryson DeChambeau - Vegas, Baby!"
}
]
}
},
{
"contract":{
"name":"Gaia",
"address":"0x8b148183c28ff88f",
"externalDomain":"ballerz.xyz",
"contractMetadata":{
"storagePath":"Gaia.CollectionStoragePath",
"publicPath":"Gaia.CollectionPublicPath",
"publicCollectionName":"Gaia.CollectionPublic"
}
},
"id":{
"tokenId":"9819",
"tokenMetadata":{
"uuid":"83524443"
}
},
"title":"Bryson DeChambeau - Vegas, Baby!",
"description":"Commemorating Bryson DeChambeau’s November 26, 2021 event in Las Vegas, NV",
"media":{
"uri":"ipfs://QmScvqCQ8PouGdPECBbE9DznAAZaTYT7ekkbyNkKYhTq3W",
"mimeType":"image"
},
"metadata":{
"metadata":[
{
"name":"item",
"value":"1"
},
{
"name":"editions",
"value":"5000"
},
{
"name":"location",
"value":"Las Vegas, NV"
},
{
"name":"video",
"value":"ipfs://QmS5UE3fAYSgpsAXgS6wAqAJc2v7gRxN6QFLxZ92FNZ1Y6"
},
{
"name":"description",
"value":"Commemorating Bryson DeChambeau’s November 26, 2021 event in Las Vegas, NV"
},
{
"name":"series",
"value":"Bryson DeChambeau - Vegas, Baby!"
},
{
"name":"type",
"value":"Golf"
},
{
"name":"img",
"value":"ipfs://QmScvqCQ8PouGdPECBbE9DznAAZaTYT7ekkbyNkKYhTq3W"
},
{
"name":"title",
"value":"Bryson DeChambeau - Vegas, Baby!"
}
]
}
},
{
"contract":{
"name":"Gaia",
"address":"0x8b148183c28ff88f",
"externalDomain":"ballerz.xyz",
"contractMetadata":{
"storagePath":"Gaia.CollectionStoragePath",
"publicPath":"Gaia.CollectionPublicPath",
"publicCollectionName":"Gaia.CollectionPublic"
}
},
"id":{
"tokenId":"13956",
"tokenMetadata":{
"uuid":"84026920"
}
},
"title":"Bryson DeChambeau - Vegas, Baby!",
"description":"Commemorating Bryson DeChambeau’s November 26, 2021 event in Las Vegas, NV",
"media":{
"uri":"ipfs://QmScvqCQ8PouGdPECBbE9DznAAZaTYT7ekkbyNkKYhTq3W",
"mimeType":"image"
},
"metadata":{
"metadata":[
{
"name":"item",
"value":"1"
},
{
"name":"editions",
"value":"5000"
},
{
"name":"location",
"value":"Las Vegas, NV"
},
{
"name":"video",
"value":"ipfs://QmS5UE3fAYSgpsAXgS6wAqAJc2v7gRxN6QFLxZ92FNZ1Y6"
},
{
"name":"description",
"value":"Commemorating Bryson DeChambeau’s November 26, 2021 event in Las Vegas, NV"
},
{
"name":"series",
"value":"Bryson DeChambeau - Vegas, Baby!"
},
{
"name":"type",
"value":"Golf"
},
{
"name":"img",
"value":"ipfs://QmScvqCQ8PouGdPECBbE9DznAAZaTYT7ekkbyNkKYhTq3W"
},
{
"name":"title",
"value":"Bryson DeChambeau - Vegas, Baby!"
}
]
}
}
],
"chain":"FLOW",
"network":"FLOW_MAINNET",
"nftCount":4830,
"offset":0
}
Copy link
On this page
Parameters
Returns
Example
Request
Response