Get NFTs (ETH/Polygon/Goerli)
Endpoint to retrieve all of a user's NFTs on the Ethereum, Polygon and Goerli blockchains.
Get NFTs
GET https://api.withmystic.xyz/marketplace-api/get-nfts
Receives a wallet address and chain Id and returns the respective wallet balance.
Query Parameters
Name
Type
Description
address*
String
Wallet address whose NFTs we want to get
chainId*
number
Id of the blockchain whose NFTs we want to get
Headers
Name
Type
Description
Bearer token*
String
Your API key
{
"ownedNfts":[
{
"contract":{
"address":"0x037aca480459ae361a87b023f189532d80cb6769",
"name":"Red Apples",
"symbol":"REDAPPLE",
"totalSupply":"63",
"tokenType":"ERC721",
"openSea":{
"lastIngestedAt":"2023-08-22T07:47:00.000Z"
},
"contractDeployer":"0xdd305dcf8c019b2e89ccecfedd80093726f611ef",
"deployedBlockNumber":8223329
},
"tokenId":"7",
"tokenType":"ERC721",
"title":"Apples Mock NFTS",
"description":"This are Mock NFTS sharing the Same Image. They are used for testing in mysticswap.io",
"timeLastUpdated":"2023-06-16T14:18:52.421Z",
"rawMetadata":{
"date":1672329470274,
"image":"https://ipfs.io/ipfs/bafkreidhpw7njnpejg3ba3ygarti4nvk4paix2u6p4j3foccp3plhd2rny",
"external_url":"https://mysticswap.io",
"name":"Apples Mock NFTS",
"description":"This are Mock NFTS sharing the Same Image. They are used for testing in mysticswap.io",
"edition":1,
"attributes":[
{
"value":"Red",
"trait_type":"Color"
},
{
"value":"Medium",
"trait_type":"Size"
}
]
},
"tokenUri":{
"gateway":"https://ipfs.io/ipfs/bafkreiaxar3ugc7wp3cumxb3albbhvodfnmbtpj5ba6sqqq3ftomwhdi4m",
"raw":"https://ipfs.io/ipfs/bafkreiaxar3ugc7wp3cumxb3albbhvodfnmbtpj5ba6sqqq3ftomwhdi4m"
},
"media":[
{
"gateway":"https://nft-cdn.alchemy.com/eth-goerli/cd4abfde875ed577823b5dcfe3bf8f5e",
"thumbnail":"https://res.cloudinary.com/alchemyapi/image/upload/thumbnailv2/eth-goerli/cd4abfde875ed577823b5dcfe3bf8f5e",
"raw":"https://ipfs.io/ipfs/bafkreidhpw7njnpejg3ba3ygarti4nvk4paix2u6p4j3foccp3plhd2rny",
"format":"jpeg",
"bytes":55186
}
],
"balance":1
},
{
"contract":{
"address":"0x037aca480459ae361a87b023f189532d80cb6769",
"name":"Red Apples",
"symbol":"REDAPPLE",
"totalSupply":"63",
"tokenType":"ERC721",
"openSea":{
"lastIngestedAt":"2023-08-22T07:47:00.000Z"
},
"contractDeployer":"0xdd305dcf8c019b2e89ccecfedd80093726f611ef",
"deployedBlockNumber":8223329
},
"tokenId":"48",
"tokenType":"ERC721",
"title":"Apples Mock NFTS",
"description":"This are Mock NFTS sharing the Same Image. They are used for testing in mysticswap.io",
"timeLastUpdated":"2023-06-09T19:03:26.482Z",
"rawMetadata":{
"date":1672329470274,
"image":"https://ipfs.io/ipfs/bafkreidhpw7njnpejg3ba3ygarti4nvk4paix2u6p4j3foccp3plhd2rny",
"external_url":"https://mysticswap.io",
"name":"Apples Mock NFTS",
"description":"This are Mock NFTS sharing the Same Image. They are used for testing in mysticswap.io",
"edition":1,
"attributes":[
{
"value":"Red",
"trait_type":"Color"
},
{
"value":"Medium",
"trait_type":"Size"
}
]
},
"tokenUri":{
"gateway":"https://alchemy.mypinata.cloud/ipfs/bafkreiaxar3ugc7wp3cumxb3albbhvodfnmbtpj5ba6sqqq3ftomwhdi4m",
"raw":"https://ipfs.io/ipfs/bafkreiaxar3ugc7wp3cumxb3albbhvodfnmbtpj5ba6sqqq3ftomwhdi4m"
},
"media":[
{
"gateway":"https://nft-cdn.alchemy.com/eth-goerli/2a206aae85e2b15d9932c714f4239d31",
"thumbnail":"https://res.cloudinary.com/alchemyapi/image/upload/thumbnailv2/eth-goerli/2a206aae85e2b15d9932c714f4239d31",
"raw":"https://ipfs.io/ipfs/bafkreidhpw7njnpejg3ba3ygarti4nvk4paix2u6p4j3foccp3plhd2rny",
"format":"jpeg",
"bytes":55186
}
],
"balance":1
},
{
"contract":{
"address":"0x15191ea18e2e0ea548841c7049e4b106650cb44e",
"name":"Red Apples",
"symbol":"REDAPPLE",
"totalSupply":"66",
"tokenType":"ERC721",
"openSea":{
"lastIngestedAt":"2023-08-17T21:29:53.000Z"
},
"contractDeployer":"0x6d0dd406df66b0da57e0002b7afd9c54d2d72916",
"deployedBlockNumber":7560722
},
"tokenId":"29",
"tokenType":"ERC721",
"title":"",
"description":"",
"timeLastUpdated":"2023-08-24T19:19:58.472Z",
"metadataError":"Malformed token uri, do not retry",
"rawMetadata":{
"metadata":[
],
"attributes":[
]
},
"media":[
],
"balance":1
},
{
"contract":{
"address":"0x229dd7144fec1008dddf5fcf779ec63c3d576aa7",
"name":"Oranges",
"symbol":"ORANGE",
"totalSupply":"46",
"tokenType":"ERC721",
"openSea":{
"lastIngestedAt":"2023-08-23T13:27:21.000Z"
},
"contractDeployer":"0xdd305dcf8c019b2e89ccecfedd80093726f611ef",
"deployedBlockNumber":8226244
},
"tokenId":"4",
"tokenType":"ERC721",
"title":"Orange Mock NFTS",
"description":"This are Mock NFTS sharing the Same Image. They are used for testing in mysticswap.io",
"timeLastUpdated":"2023-06-17T17:11:03.308Z",
"rawMetadata":{
"date":1672329470274,
"image":"https://ipfs.io/ipfs/bafkreid6lpiyizkjyl2fexdizbovhfl3ncl4ma32zuvev3v6lnsbkvfdtm",
"external_url":"https://mysticswap.io",
"name":"Orange Mock NFTS",
"description":"This are Mock NFTS sharing the Same Image. They are used for testing in mysticswap.io",
"edition":1,
"attributes":[
{
"value":"Yellow",
"trait_type":"Color"
},
{
"value":"Large",
"trait_type":"Size"
}
]
},
"tokenUri":{
"gateway":"https://ipfs.io/ipfs/bafkreiaktvjzpks4y5cxmf7lyiiwp5gcqxzizoe7lvp47ia5ronrrlsfd4",
"raw":"https://ipfs.io/ipfs/bafkreiaktvjzpks4y5cxmf7lyiiwp5gcqxzizoe7lvp47ia5ronrrlsfd4"
},
"media":[
{
"gateway":"https://nft-cdn.alchemy.com/eth-goerli/834a175db18d499ab635719c1af03dbc",
"thumbnail":"https://res.cloudinary.com/alchemyapi/image/upload/thumbnailv2/eth-goerli/834a175db18d499ab635719c1af03dbc",
"raw":"https://ipfs.io/ipfs/bafkreid6lpiyizkjyl2fexdizbovhfl3ncl4ma32zuvev3v6lnsbkvfdtm",
"format":"jpeg",
"bytes":41777
}
],
"balance":1
},
{
"contract":{
"address":"0x037aca480459ae361a87b023f189532d80cb6769",
"name":"Red Apples",
"symbol":"REDAPPLE",
"totalSupply":"63",
"tokenType":"ERC721",
"openSea":{
"lastIngestedAt":"2023-08-22T07:47:00.000Z"
},
"contractDeployer":"0xdd305dcf8c019b2e89ccecfedd80093726f611ef",
"deployedBlockNumber":8223329
},
"tokenId":"46",
"tokenType":"ERC721",
"title":"Apples Mock NFTS",
"description":"This are Mock NFTS sharing the Same Image. They are used for testing in mysticswap.io",
"timeLastUpdated":"2023-08-11T16:19:41.014Z",
"rawMetadata":{
"date":1672329470274,
"image":"https://ipfs.io/ipfs/bafkreidhpw7njnpejg3ba3ygarti4nvk4paix2u6p4j3foccp3plhd2rny",
"external_url":"https://mysticswap.io",
"name":"Apples Mock NFTS",
"description":"This are Mock NFTS sharing the Same Image. They are used for testing in mysticswap.io",
"edition":1,
"attributes":[
{
"value":"Red",
"trait_type":"Color"
},
{
"value":"Medium",
"trait_type":"Size"
}
]
},
"tokenUri":{
"gateway":"https://alchemy.mypinata.cloud/ipfs/bafkreiaxar3ugc7wp3cumxb3albbhvodfnmbtpj5ba6sqqq3ftomwhdi4m",
"raw":"https://ipfs.io/ipfs/bafkreiaxar3ugc7wp3cumxb3albbhvodfnmbtpj5ba6sqqq3ftomwhdi4m"
},
"media":[
{
"gateway":"https://nft-cdn.alchemy.com/eth-goerli/62ed77fa507e8235e867d04c5217e007",
"thumbnail":"https://res.cloudinary.com/alchemyapi/image/upload/thumbnailv2/eth-goerli/62ed77fa507e8235e867d04c5217e007",
"raw":"https://ipfs.io/ipfs/bafkreidhpw7njnpejg3ba3ygarti4nvk4paix2u6p4j3foccp3plhd2rny",
"format":"jpeg",
"bytes":55186
}
],
"balance":1
},
{
"contract":{
"address":"0x229dd7144fec1008dddf5fcf779ec63c3d576aa7",
"name":"Oranges",
"symbol":"ORANGE",
"totalSupply":"46",
"tokenType":"ERC721",
"openSea":{
"lastIngestedAt":"2023-08-23T13:27:21.000Z"
},
"contractDeployer":"0xdd305dcf8c019b2e89ccecfedd80093726f611ef",
"deployedBlockNumber":8226244
},
"tokenId":"36",
"tokenType":"ERC721",
"title":"Orange Mock NFTS",
"description":"This are Mock NFTS sharing the Same Image. They are used for testing in mysticswap.io",
"timeLastUpdated":"2023-08-11T16:19:41.866Z",
"rawMetadata":{
"date":1672329470274,
"image":"https://ipfs.io/ipfs/bafkreid6lpiyizkjyl2fexdizbovhfl3ncl4ma32zuvev3v6lnsbkvfdtm",
"external_url":"https://mysticswap.io",
"name":"Orange Mock NFTS",
"description":"This are Mock NFTS sharing the Same Image. They are used for testing in mysticswap.io",
"edition":1,
"attributes":[
{
"value":"Yellow",
"trait_type":"Color"
},
{
"value":"Large",
"trait_type":"Size"
}
]
},
"tokenUri":{
"gateway":"https://alchemy.mypinata.cloud/ipfs/bafkreiaktvjzpks4y5cxmf7lyiiwp5gcqxzizoe7lvp47ia5ronrrlsfd4",
"raw":"https://ipfs.io/ipfs/bafkreiaktvjzpks4y5cxmf7lyiiwp5gcqxzizoe7lvp47ia5ronrrlsfd4"
},
"media":[
{
"gateway":"https://nft-cdn.alchemy.com/eth-goerli/f4880a8ea160bf037d32e71c0dd83786",
"thumbnail":"https://res.cloudinary.com/alchemyapi/image/upload/thumbnailv2/eth-goerli/f4880a8ea160bf037d32e71c0dd83786",
"raw":"https://ipfs.io/ipfs/bafkreid6lpiyizkjyl2fexdizbovhfl3ncl4ma32zuvev3v6lnsbkvfdtm",
"format":"jpeg",
"bytes":41777
}
],
"balance":1
}
],
"totalCount":6,
"blockHash":"0xa0a6232119a0548ba57f76b0d003ebd9bdb32f72160d6283d468fdbe9c739d0d"
}Example
Let's try retrieving the Ethereum NFTs of the user who created and validated the swap in the Create Swap / Offer example. In this case, what we'd query the API with would be:
https://api.withmystic.xyz/marketplace-api/get-nfts?address=0xA0BC85720afB60BBda96458A87DCa21022e183ZL&chainId=1And here we can find the response we would get from making this call (mock values):
{
"ownedNfts":[
{
"contract":{
"address":"0x037aca480459ae361a87b023f189532d80cb6769",
"name":"Red Apples",
"symbol":"REDAPPLE",
"totalSupply":"63",
"tokenType":"ERC721",
"openSea":{
"lastIngestedAt":"2023-08-22T07:47:00.000Z"
},
"contractDeployer":"0xdd305dcf8c019b2e89ccecfedd80093726f611ef",
"deployedBlockNumber":8223329
},
"tokenId":"7",
"tokenType":"ERC721",
"title":"Apples Mock NFTS",
"description":"This are Mock NFTS sharing the Same Image. They are used for testing in mysticswap.io",
"timeLastUpdated":"2023-06-16T14:18:52.421Z",
"rawMetadata":{
"date":1672329470274,
"image":"https://ipfs.io/ipfs/bafkreidhpw7njnpejg3ba3ygarti4nvk4paix2u6p4j3foccp3plhd2rny",
"external_url":"https://mysticswap.io",
"name":"Apples Mock NFTS",
"description":"This are Mock NFTS sharing the Same Image. They are used for testing in mysticswap.io",
"edition":1,
"attributes":[
{
"value":"Red",
"trait_type":"Color"
},
{
"value":"Medium",
"trait_type":"Size"
}
]
},
"tokenUri":{
"gateway":"https://ipfs.io/ipfs/bafkreiaxar3ugc7wp3cumxb3albbhvodfnmbtpj5ba6sqqq3ftomwhdi4m",
"raw":"https://ipfs.io/ipfs/bafkreiaxar3ugc7wp3cumxb3albbhvodfnmbtpj5ba6sqqq3ftomwhdi4m"
},
"media":[
{
"gateway":"https://nft-cdn.alchemy.com/eth-goerli/cd4abfde875ed577823b5dcfe3bf8f5e",
"thumbnail":"https://res.cloudinary.com/alchemyapi/image/upload/thumbnailv2/eth-goerli/cd4abfde875ed577823b5dcfe3bf8f5e",
"raw":"https://ipfs.io/ipfs/bafkreidhpw7njnpejg3ba3ygarti4nvk4paix2u6p4j3foccp3plhd2rny",
"format":"jpeg",
"bytes":55186
}
],
"balance":1
},
{
"contract":{
"address":"0x037aca480459ae361a87b023f189532d80cb6769",
"name":"Red Apples",
"symbol":"REDAPPLE",
"totalSupply":"63",
"tokenType":"ERC721",
"openSea":{
"lastIngestedAt":"2023-08-22T07:47:00.000Z"
},
"contractDeployer":"0xdd305dcf8c019b2e89ccecfedd80093726f611ef",
"deployedBlockNumber":8223329
},
"tokenId":"48",
"tokenType":"ERC721",
"title":"Apples Mock NFTS",
"description":"This are Mock NFTS sharing the Same Image. They are used for testing in mysticswap.io",
"timeLastUpdated":"2023-06-09T19:03:26.482Z",
"rawMetadata":{
"date":1672329470274,
"image":"https://ipfs.io/ipfs/bafkreidhpw7njnpejg3ba3ygarti4nvk4paix2u6p4j3foccp3plhd2rny",
"external_url":"https://mysticswap.io",
"name":"Apples Mock NFTS",
"description":"This are Mock NFTS sharing the Same Image. They are used for testing in mysticswap.io",
"edition":1,
"attributes":[
{
"value":"Red",
"trait_type":"Color"
},
{
"value":"Medium",
"trait_type":"Size"
}
]
},
"tokenUri":{
"gateway":"https://alchemy.mypinata.cloud/ipfs/bafkreiaxar3ugc7wp3cumxb3albbhvodfnmbtpj5ba6sqqq3ftomwhdi4m",
"raw":"https://ipfs.io/ipfs/bafkreiaxar3ugc7wp3cumxb3albbhvodfnmbtpj5ba6sqqq3ftomwhdi4m"
},
"media":[
{
"gateway":"https://nft-cdn.alchemy.com/eth-goerli/2a206aae85e2b15d9932c714f4239d31",
"thumbnail":"https://res.cloudinary.com/alchemyapi/image/upload/thumbnailv2/eth-goerli/2a206aae85e2b15d9932c714f4239d31",
"raw":"https://ipfs.io/ipfs/bafkreidhpw7njnpejg3ba3ygarti4nvk4paix2u6p4j3foccp3plhd2rny",
"format":"jpeg",
"bytes":55186
}
],
"balance":1
},
{
"contract":{
"address":"0x15191ea18e2e0ea548841c7049e4b106650cb44e",
"name":"Red Apples",
"symbol":"REDAPPLE",
"totalSupply":"66",
"tokenType":"ERC721",
"openSea":{
"lastIngestedAt":"2023-08-17T21:29:53.000Z"
},
"contractDeployer":"0x6d0dd406df66b0da57e0002b7afd9c54d2d72916",
"deployedBlockNumber":7560722
},
"tokenId":"29",
"tokenType":"ERC721",
"title":"",
"description":"",
"timeLastUpdated":"2023-08-24T19:19:58.472Z",
"metadataError":"Malformed token uri, do not retry",
"rawMetadata":{
"metadata":[
],
"attributes":[
]
},
"media":[
],
"balance":1
},
{
"contract":{
"address":"0x229dd7144fec1008dddf5fcf779ec63c3d576aa7",
"name":"Oranges",
"symbol":"ORANGE",
"totalSupply":"46",
"tokenType":"ERC721",
"openSea":{
"lastIngestedAt":"2023-08-23T13:27:21.000Z"
},
"contractDeployer":"0xdd305dcf8c019b2e89ccecfedd80093726f611ef",
"deployedBlockNumber":8226244
},
"tokenId":"4",
"tokenType":"ERC721",
"title":"Orange Mock NFTS",
"description":"This are Mock NFTS sharing the Same Image. They are used for testing in mysticswap.io",
"timeLastUpdated":"2023-06-17T17:11:03.308Z",
"rawMetadata":{
"date":1672329470274,
"image":"https://ipfs.io/ipfs/bafkreid6lpiyizkjyl2fexdizbovhfl3ncl4ma32zuvev3v6lnsbkvfdtm",
"external_url":"https://mysticswap.io",
"name":"Orange Mock NFTS",
"description":"This are Mock NFTS sharing the Same Image. They are used for testing in mysticswap.io",
"edition":1,
"attributes":[
{
"value":"Yellow",
"trait_type":"Color"
},
{
"value":"Large",
"trait_type":"Size"
}
]
},
"tokenUri":{
"gateway":"https://ipfs.io/ipfs/bafkreiaktvjzpks4y5cxmf7lyiiwp5gcqxzizoe7lvp47ia5ronrrlsfd4",
"raw":"https://ipfs.io/ipfs/bafkreiaktvjzpks4y5cxmf7lyiiwp5gcqxzizoe7lvp47ia5ronrrlsfd4"
},
"media":[
{
"gateway":"https://nft-cdn.alchemy.com/eth-goerli/834a175db18d499ab635719c1af03dbc",
"thumbnail":"https://res.cloudinary.com/alchemyapi/image/upload/thumbnailv2/eth-goerli/834a175db18d499ab635719c1af03dbc",
"raw":"https://ipfs.io/ipfs/bafkreid6lpiyizkjyl2fexdizbovhfl3ncl4ma32zuvev3v6lnsbkvfdtm",
"format":"jpeg",
"bytes":41777
}
],
"balance":1
},
{
"contract":{
"address":"0x037aca480459ae361a87b023f189532d80cb6769",
"name":"Red Apples",
"symbol":"REDAPPLE",
"totalSupply":"63",
"tokenType":"ERC721",
"openSea":{
"lastIngestedAt":"2023-08-22T07:47:00.000Z"
},
"contractDeployer":"0xdd305dcf8c019b2e89ccecfedd80093726f611ef",
"deployedBlockNumber":8223329
},
"tokenId":"46",
"tokenType":"ERC721",
"title":"Apples Mock NFTS",
"description":"This are Mock NFTS sharing the Same Image. They are used for testing in mysticswap.io",
"timeLastUpdated":"2023-08-11T16:19:41.014Z",
"rawMetadata":{
"date":1672329470274,
"image":"https://ipfs.io/ipfs/bafkreidhpw7njnpejg3ba3ygarti4nvk4paix2u6p4j3foccp3plhd2rny",
"external_url":"https://mysticswap.io",
"name":"Apples Mock NFTS",
"description":"This are Mock NFTS sharing the Same Image. They are used for testing in mysticswap.io",
"edition":1,
"attributes":[
{
"value":"Red",
"trait_type":"Color"
},
{
"value":"Medium",
"trait_type":"Size"
}
]
},
"tokenUri":{
"gateway":"https://alchemy.mypinata.cloud/ipfs/bafkreiaxar3ugc7wp3cumxb3albbhvodfnmbtpj5ba6sqqq3ftomwhdi4m",
"raw":"https://ipfs.io/ipfs/bafkreiaxar3ugc7wp3cumxb3albbhvodfnmbtpj5ba6sqqq3ftomwhdi4m"
},
"media":[
{
"gateway":"https://nft-cdn.alchemy.com/eth-goerli/62ed77fa507e8235e867d04c5217e007",
"thumbnail":"https://res.cloudinary.com/alchemyapi/image/upload/thumbnailv2/eth-goerli/62ed77fa507e8235e867d04c5217e007",
"raw":"https://ipfs.io/ipfs/bafkreidhpw7njnpejg3ba3ygarti4nvk4paix2u6p4j3foccp3plhd2rny",
"format":"jpeg",
"bytes":55186
}
],
"balance":1
},
{
"contract":{
"address":"0x229dd7144fec1008dddf5fcf779ec63c3d576aa7",
"name":"Oranges",
"symbol":"ORANGE",
"totalSupply":"46",
"tokenType":"ERC721",
"openSea":{
"lastIngestedAt":"2023-08-23T13:27:21.000Z"
},
"contractDeployer":"0xdd305dcf8c019b2e89ccecfedd80093726f611ef",
"deployedBlockNumber":8226244
},
"tokenId":"36",
"tokenType":"ERC721",
"title":"Orange Mock NFTS",
"description":"This are Mock NFTS sharing the Same Image. They are used for testing in mysticswap.io",
"timeLastUpdated":"2023-08-11T16:19:41.866Z",
"rawMetadata":{
"date":1672329470274,
"image":"https://ipfs.io/ipfs/bafkreid6lpiyizkjyl2fexdizbovhfl3ncl4ma32zuvev3v6lnsbkvfdtm",
"external_url":"https://mysticswap.io",
"name":"Orange Mock NFTS",
"description":"This are Mock NFTS sharing the Same Image. They are used for testing in mysticswap.io",
"edition":1,
"attributes":[
{
"value":"Yellow",
"trait_type":"Color"
},
{
"value":"Large",
"trait_type":"Size"
}
]
},
"tokenUri":{
"gateway":"https://alchemy.mypinata.cloud/ipfs/bafkreiaktvjzpks4y5cxmf7lyiiwp5gcqxzizoe7lvp47ia5ronrrlsfd4",
"raw":"https://ipfs.io/ipfs/bafkreiaktvjzpks4y5cxmf7lyiiwp5gcqxzizoe7lvp47ia5ronrrlsfd4"
},
"media":[
{
"gateway":"https://nft-cdn.alchemy.com/eth-goerli/f4880a8ea160bf037d32e71c0dd83786",
"thumbnail":"https://res.cloudinary.com/alchemyapi/image/upload/thumbnailv2/eth-goerli/f4880a8ea160bf037d32e71c0dd83786",
"raw":"https://ipfs.io/ipfs/bafkreid6lpiyizkjyl2fexdizbovhfl3ncl4ma32zuvev3v6lnsbkvfdtm",
"format":"jpeg",
"bytes":41777
}
],
"balance":1
}
],
"totalCount":6,
"blockHash":"0xa0a6232119a0548ba57f76b0d003ebd9bdb32f72160d6283d468fdbe9c739d0d"
}Here is an example API call, for you to copy and modify:
https://api.withmystic.xyz/marketplace-api/get-nfts?address=string&chainId=numberHappy coding!
Last updated