Links

account_nftPortfolio

Get NFT assets and NFT metadata owned by any account address.
Through account_nftPortfolio, you can fetch the broad NFT data owned by certain holder, such as the amount, the value and metadata, etc., accountAddress is necessary. 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(array of object, 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
TypeScript
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
}
}'
import { BlockVisionProvider, BvNetwork } from 'blockvision.js'
// Optional parameters, but default to eth-mainnet and default api-key.
const bv = new BlockVisionProvider(BvNetwork.ETH_MAINNET)
// Access the BlockVision Account API
bv.getAccountNFTPortfolio({
accountAddress: '0x8Bc47bE1e3ABBaBa182069C89d08a61FA6C2B292'
}).then(console.log)

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
}
}