Alchemy x Flow
WebsiteDashboardRoadmap
Search…
👋
Welcome to Alchemy's Flow Docs!
Documentation
Flow Access HTTP API
Flow Access gRPC API
Flow NFT APIs
getNFTs API
getNFTMetadata API
Compute Units
Official Flow Documentation
Guides
Getting Started
Other Chains
Ethereum Docs
Crypto.org Docs
Powered By GitBook
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
}
Documentation - Previous
Flow NFT APIs
Next
getNFTMetadata API
Last modified 7mo ago
Copy link
On this page
Parameters
Returns
Example
Request
Response