account_nftPortfolio
Help you to quickly query the NFT assets and NFT metadata owned by any account address.
You can specify the account address and contract address, then you could obtain the broad NFT data owned by certain holder, such as the amount, the value and metadata, etc. Using this API, you can get the detailed information of NFTs of certain holders. Some investigation and marketing strategies could be made by calling this API.
Supported on Ethereum and BNB Chain.

Parameters

Object - An object with the following fields (required):
  • accountAddress(hex string, required) - the account address you want to query.
  • contractAddress(hex string, optional) - the contract address of the collection. BlockVision currently support both ERC721 and ERC1155.
  • pageSize(integer number, optional, default 20) - max number of results to return per call.
  • pageIndex(integer number, optional, default 1) - page index.

Returns

Object - An object with the following fields:
  • id(integer number) - JSON-RPC id.
  • jsonrpc(string) - JSON-RPC version.
  • result(object) - an object with the following fields:
    • nextPageIndex(integer number) - next page.
    • total(integer number) - the amount of the records.
    • data(object array, defined below) - descending order by marketCap.
  • Object schema:
    • contractAddress(string) - the contract address of the collection.
    • tokenID(string) - id of the NFT.
    • amount(float) - the NFT transaction price with decimals.
    • quantity(integer number) - the NFT quantity.
    • usdAmount(float) - the NFT transaction price of USD.
    • currency(string) - the currency for payment.
    • standard(string) - the NFT standard like ERC721, ERC1155.
    • metadata(object) - an object with the following fields:
      • imageURL(string) - the URL of NFT image.
      • gatewayImageURL(string) - the NFT gateway image url.
      • name(string) - the name of NFT.
      • collection(string) - the name of the collection.

Example

Request

curl https://api.blockvision.org/v1/<api key> \
-X POST \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 0,
"method": "account_nftPortfolio",
"params": {
"accountAddress": "0x8Bc47bE1e3ABBaBa182069C89d08a61FA6C2B292",
"pageIndex": 1,
"pageSize": 20
}
}'

Result

{
"jsonrpc": "2.0",
"id": 0,
"result": {
"data": [
{
"contractAddress": "0x080B2B89e7A7014145c198D84F9fBeBf124eD2e8",
"tokenId": "1948",
"amount": 0,
"quantity": 1,
"usdAmount": 0,
"currency": "",
"standard": "erc721",
"metadata": {
"imageURL": "ipfs://QmZGqbgqrJc2GPzj4jjasiNZgAmPys4Dj7Hursi8yJrGWs",
"gatewayImageURL": "https://ipfs.io/ipfs/QmZGqbgqrJc2GPzj4jjasiNZgAmPys4Dj7Hursi8yJrGWs",
"name": "Azuki x Gutter Punks",
"collectionName": "Azuki x Gutter Punks"
}
},
{
"contractAddress": "0x0D125b4A5c423713860F21cC4E9558b092411bbD",
"tokenId": "4298",
"amount": 0,
"quantity": 1,
"usdAmount": 0,
"currency": "",
"standard": "erc721",
"metadata": {
"imageURL": "ipfs://QmdKCPwPH88rgcdNRpTr473PKSgAg42TyskggAPrRBUcn7",
"gatewayImageURL": "https://ipfs.io/ipfs/QmdKCPwPH88rgcdNRpTr473PKSgAg42TyskggAPrRBUcn7",
"name": "Lil Frens",
"collectionName": "Lil Frens"
}
},
{
"contractAddress": "0x10DaA9f4c0F985430fdE4959adB2c791ef2CCF83",
"tokenId": "2",
"amount": 1.7,
"quantity": 1,
"usdAmount": 0,
"currency": "WETH",
"standard": "erc1155",
"metadata": {
"imageURL": "ipfs://ipfs/QmTMG4fuQcsDX7D7r7bpGSLAMC7C5eYCGKdFrKnACGJHKc/image.gif",
"gatewayImageURL": "https://ipfs.io/ipfs/QmTMG4fuQcsDX7D7r7bpGSLAMC7C5eYCGKdFrKnACGJHKc/image.gif",
"name": "Metakey: Edition Two - RTFKTstudios",
"collectionName": "Metakey: Edition Two - RTFKTstudios"
}
},
{
"contractAddress": "0x143e0D5D30cf207b8FE78cC21D177A3137649a14",
"tokenId": "1",
"amount": 0,
"quantity": 1,
"usdAmount": 0,
"currency": "",
"standard": "erc1155",
"metadata": {
"imageURL": "https://arweave.net/7rCYaQifUyMmRfpKbZZfHZELSzLe5tOfmbUq_o0zWp8",
"gatewayImageURL": "https://arweave.net/7rCYaQifUyMmRfpKbZZfHZELSzLe5tOfmbUq_o0zWp8",
"name": "174 [respectful lemons]",
"collectionName": "174 [respectful lemons]"
}
},
{
"contractAddress": "0x1CB1A5e65610AEFF2551A50f76a87a7d3fB649C6",
"tokenId": "4147",
"amount": 3.94,
"quantity": 1,
"usdAmount": 11580.3692,
"currency": "ETH",
"standard": "erc721",
"metadata": {
"imageURL": "ipfs://QmXet2r82bjnEdwdvG4aCxJ6ka7jQizBBZhuGcehnvC21p",
"gatewayImageURL": "https://ipfs.io/ipfs/QmXet2r82bjnEdwdvG4aCxJ6ka7jQizBBZhuGcehnvC21p",
"name": "CrypToadz #4147",
"collectionName": "CrypToadz #4147"
}
},
{
"contractAddress": "0x1CB1A5e65610AEFF2551A50f76a87a7d3fB649C6",
"tokenId": "3361",
"amount": 4.09,
"quantity": 1,
"usdAmount": 12021.2462,
"currency": "ETH",
"standard": "erc721",
"metadata": {
"imageURL": "ipfs://QmTnzYedADVrvzpQwu6JvQsjou1UvAwS4FshCyZVbc2tu5",
"gatewayImageURL": "https://ipfs.io/ipfs/QmTnzYedADVrvzpQwu6JvQsjou1UvAwS4FshCyZVbc2tu5",
"name": "CrypToadz #3361",
"collectionName": "CrypToadz #3361"
}
},
{
"contractAddress": "0x1CB1A5e65610AEFF2551A50f76a87a7d3fB649C6",
"tokenId": "753",
"amount": 3.65,
"quantity": 1,
"usdAmount": 10728.007,
"currency": "WETH",
"standard": "erc721",
"metadata": {
"imageURL": "ipfs://QmcadKDXH3Vzc3UY2TrD9Hkex2VCSGwFPhU7bfgY3ELUvU",
"gatewayImageURL": "https://ipfs.io/ipfs/QmcadKDXH3Vzc3UY2TrD9Hkex2VCSGwFPhU7bfgY3ELUvU",
"name": "CrypToadz #753",
"collectionName": "CrypToadz #753"
}
},
{
"contractAddress": "0x1D20A51F088492A0f1C57f047A9e30c9aB5C07Ea",
"tokenId": "11657",
"amount": 0.54,
"quantity": 1,
"usdAmount": 2003.4054,
"currency": "ETH",
"standard": "erc721",
"metadata": {
"imageURL": "https://arweave.net/ABckdetHKeV8VgUoIZ53TMDKkTi56LhTf-Gb1Mdqx9c/11657.png",
"gatewayImageURL": "https://arweave.net/ABckdetHKeV8VgUoIZ53TMDKkTi56LhTf-Gb1Mdqx9c/11657.png",
"name": "Wassie 11657",
"collectionName": "Wassie 11657"
}
},
{
"contractAddress": "0x1D20A51F088492A0f1C57f047A9e30c9aB5C07Ea",
"tokenId": "10542",
"amount": 0.8,
"quantity": 1,
"usdAmount": 2968.008,
"currency": "ETH",
"standard": "erc721",
"metadata": {
"imageURL": "https://arweave.net/ABckdetHKeV8VgUoIZ53TMDKkTi56LhTf-Gb1Mdqx9c/10542.png",
"gatewayImageURL": "https://arweave.net/ABckdetHKeV8VgUoIZ53TMDKkTi56LhTf-Gb1Mdqx9c/10542.png",
"name": "Outcast 10542",
"collectionName": "Outcast 10542"
}
},
{
"contractAddress": "0x1D20A51F088492A0f1C57f047A9e30c9aB5C07Ea",
"tokenId": "10117",
"amount": 0.79,
"quantity": 1,
"usdAmount": 2930.9079,
"currency": "ETH",
"standard": "erc721",
"metadata": {
"imageURL": "https://arweave.net/ABckdetHKeV8VgUoIZ53TMDKkTi56LhTf-Gb1Mdqx9c/10117.png",
"gatewayImageURL": "https://arweave.net/ABckdetHKeV8VgUoIZ53TMDKkTi56LhTf-Gb1Mdqx9c/10117.png",
"name": "Outcast 10117",
"collectionName": "Outcast 10117"
}
},
{
"contractAddress": "0x1e0e008EeC6D04C52A3945d3Df33D04e06A9C46F",
"tokenId": "7894",
"amount": 0,
"quantity": 1,
"usdAmount": 0,
"currency": "",
"standard": "erc721",
"metadata": {
"imageURL": "ipfs://Qmf5cvyAyfo7Dg8C7fbJYw5aDw2VG7ZcQTyoK3KEUzo4JK",
"gatewayImageURL": "https://ipfs.io/ipfs/Qmf5cvyAyfo7Dg8C7fbJYw5aDw2VG7ZcQTyoK3KEUzo4JK",
"name": "BAYC x Gutter Punks",
"collectionName": "BAYC x Gutter Punks"
}
},
{
"contractAddress": "0x2079812353E2C9409a788FBF5f383fa62aD85bE8",
"tokenId": "1",
"amount": 0.169,
"quantity": 10,
"usdAmount": 496.85662,
"currency": "WETH",
"standard": "erc1155",
"metadata": {
"imageURL": "https://ikzttp.mypinata.cloud/ipfs/QmYDvPAXtiJg7s8JdRBSLWdgSphQdac8j1YuQNNxcGE1hg/40.png",
"gatewayImageURL": "https://ikzttp.mypinata.cloud/ipfs/QmYDvPAXtiJg7s8JdRBSLWdgSphQdac8j1YuQNNxcGE1hg/40.png",
"name": "Bobu Token (Azuki #40)",
"collectionName": "Bobu Token (Azuki #40)"
}
},
{
"contractAddress": "0x2A187453064356c898cAe034EAed119E1663ACb8",
"tokenId": "98966416164979387281289317851795164508394262924684608644398940047088614614986",
"amount": 0,
"quantity": 1,
"usdAmount": 0,
"currency": "",
"standard": "erc721",
"metadata": {
"imageURL": "",
"gatewayImageURL": "",
"name": "",
"collectionName": ""
}
},
{
"contractAddress": "0x2aF75676692817d85121353f0D6e8E9aE6AD5576",
"tokenId": "57904913443593563587705127578369762228275238192067040688203460848780044155756",
"amount": 0,
"quantity": 1,
"usdAmount": 0,
"currency": "",
"standard": "erc721",
"metadata": {
"imageURL": "https://assets.f1deltatime.com/image/nft/2020_wettyres_common.png",
"gatewayImageURL": "https://assets.f1deltatime.com/image/nft/2020_wettyres_common.png",
"name": "Wet Tyres",
"collectionName": "Wet Tyres"
}
},
{
"contractAddress": "0x2aF75676692817d85121353f0D6e8E9aE6AD5576",
"tokenId": "57904906541847216797141340143613899951181994768362480510915952621947782708071",
"amount": 0,
"quantity": 1,
"usdAmount": 0,
"currency": "",
"standard": "erc721",
"metadata": {
"imageURL": "https://assets.f1deltatime.com/image/nft/2020_intermediatetyres_common.png",
"gatewayImageURL": "https://assets.f1deltatime.com/image/nft/2020_intermediatetyres_common.png",
"name": "Intermediate Tyres",
"collectionName": "Intermediate Tyres"
}
},
{
"contractAddress": "0x2aF75676692817d85121353f0D6e8E9aE6AD5576",
"tokenId": "57904892738354523216013669493130871279171817596350000998146264049282745115861",
"amount": 0.059,
"quantity": 1,
"usdAmount": 137.07293,
"currency": "ETH",
"standard": "erc721",
"metadata": {
"imageURL": "https://assets.f1deltatime.com/image/nft/2020_mediumtyres_common.png",
"gatewayImageURL": "https://assets.f1deltatime.com/image/nft/2020_mediumtyres_common.png",
"name": "Medium Tyres",
"collectionName": "Medium Tyres"
}
},
{
"contractAddress": "0x2aF75676692817d85121353f0D6e8E9aE6AD5576",
"tokenId": "57903132793036091622247969411357294755651348819608804588612505377192850504552",
"amount": 0,
"quantity": 1,
"usdAmount": 0,
"currency": "",
"standard": "erc721",
"metadata": {
"imageURL": "https://assets.f1deltatime.com/image/nft/2020_helmet_common.png",
"gatewayImageURL": "https://assets.f1deltatime.com/image/nft/2020_helmet_common.png",
"name": "Helmet",
"collectionName": "Helmet"
}
},
{
"contractAddress": "0x2aF75676692817d85121353f0D6e8E9aE6AD5576",
"tokenId": "57903132793036091622247777849414686519578614907387880284092135042516181334889",
"amount": 0,
"quantity": 1,
"usdAmount": 0,
"currency": "",
"standard": "erc721",
"metadata": {
"imageURL": "https://assets.f1deltatime.com/image/nft/2020_helmet_common.png",
"gatewayImageURL": "https://assets.f1deltatime.com/image/nft/2020_helmet_common.png",
"name": "Helmet",
"collectionName": "Helmet"
}
},
{
"contractAddress": "0x2aF75676692817d85121353f0D6e8E9aE6AD5576",
"tokenId": "57901393552956700400173152728994784473234091056104507449180919490078174100330",
"amount": 0,
"quantity": 1,
"usdAmount": 0,
"currency": "",
"standard": "erc721",
"metadata": {
"imageURL": "https://assets.f1deltatime.com/image/nft/2020_transmission_rare.png",
"gatewayImageURL": "https://assets.f1deltatime.com/image/nft/2020_transmission_rare.png",
"name": "Transmission",
"collectionName": "Transmission"
}
},
{
"contractAddress": "0x2aF75676692817d85121353f0D6e8E9aE6AD5576",
"tokenId": "57901379749464006819045865202396972273225826484399544455737390134778965015406",
"amount": 0,
"quantity": 1,
"usdAmount": 0,
"currency": "",
"standard": "erc721",
"metadata": {
"imageURL": "https://assets.f1deltatime.com/image/nft/2020_energystore_common.png",
"gatewayImageURL": "https://assets.f1deltatime.com/image/nft/2020_energystore_common.png",
"name": "Energy Store",
"collectionName": "Energy Store"
}
}
],
"nextPageIndex": 2,
"total": 196
}
}
Copy link
Outline
Parameters
Returns
Example
Request
Result