1 of 4

Non Fungible Tokens

Provides functionalities to get details of non fungible tokens.

Following are the common functions implemented for the Non Fungible Tokens:-

Name

Type

Description

ERC721

/getbalance

Retrieves the number of NFTs held in the owner's account. Currently available on Ethereum, Polygon, BSC, Avalanche, and zkSync.

GET https://api.expand.network/nft/getbalance

Query Parameters

Name

Type

Description

https://api.expand.network/nft/getbalance?nftCollection=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&address=0xc5c7b46843014B1591e9aF24de797156cde67f08

{
    "status": 200,
    "msg": "success",
    "data": {
        "balance": "2"
    }
}

/getmetadata

Retrieves the metadata for the specified NFT. Currently available on Ethereum, Polygon, BSC, Avalanche, and zkSync.

GET https://api.expand.network/nft/getmetadata

Query Parameters

https://api.expand.network/nft/getmetadata?nftCollection=0x5af0d9827e0c53e4799bb226655a1de152a425a5

{
    "status": 200,
    "msg": "success",
    "data": {
        "name": "Milady",
        "symbol": "MIL"
    }
}

/getowner

Retrieves the owner of the specified token ID. Currently available on Ethereum, Polygon, BSC, Avalanche, and zkSync.

GET https://api.expand.network/nft/getowner

Query Parameters

https://api.expand.network/nft/getowner?nftIndex=1000&nftCollection=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D

{
    "status": 200,
    "msg": "success",
    "data": {
        "owner": "0x68761dE35422d8e36d18dC2F7f6313a58c1a3616"
    }
}

/historical/transactions

Retrieves past transactions associated with a designated address, sorted based on an NFT token contract, and limited within a specific block range. Currently available on ethereum.

GET https://api.expand.network/nft/historical/transactions

Query Parameters

https://api.expand.network/nft/historical/transactions?chainId=1&nftProtocolId=721&startBlock=0&nftCollection=0x306b1ea3ecdf94aB739F1910bbda052Ed4A9f949&page=1&sort=desc

{
    "status": 200,
    "msg": "success",
    "data": {
        "transactions": [
            {
                "blockNumber": "18968332",
                "timeStamp": "1704790283",
                "hash": "0x719286621b2b2e4aeda8e61a0ce2e58bd6f4806d1d411653172ec5380ec2c3d6",
                "nonce": "722",
                "blockHash": "0x6929852257b9d94b5f9b5908d851a25488d3a2afd11c103229f7a8fb305b5898",
                "from": "0x2efdb6dd6daa243fdf30cac2391adb8350d5e322",
                "contractAddress": "0x306b1ea3ecdf94ab739f1910bbda052ed4a9f949",
                "to": "0xae78174d3ab843dd349acb975ed1b3b1431a55e8",
                "tokenID": "769",
                "tokenName": "Beanz",
                "tokenSymbol": "BEANZ",
                "tokenDecimal": "0",
                "transactionIndex": "43",
                "gas": "173141",
                "gasPrice": "16138857662",
                "gasUsed": "128215",
                "cumulativeGasUsed": "9277786",
                "input": "deprecated",
                "confirmations": "513",
                "methodId": "0x00000000",
                "methodSignature": "get_block_hash_257335279069929(uint256)"
            },
            ...
        ]
    }
}

/historical/logs

Retrieves historical logs for any nftCollection. Currently available on ethereum.

GET https://api.expand.network/nft/historical/logs

Query Parameters

https://api.expand.network/nft/historical/logs?chainId=1&nftCollection=0x08D7C0242953446436F34b4C78Fe9da38c73668d&type=Transfer&startBlock=17146713&endBlock=17157177

{
    "status": 200,
    "msg": "success",
    "data": {
        "logs": [
            {
                "address": "0x08d7c0242953446436f34b4c78fe9da38c73668d",
                "topics": [
                    "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                    "0x00000000000000000000000050d36f27872f637ec9ecb4eedff300df44a608ab",
                    "0x000000000000000000000000fcbe7b6da18a08a86ab1beb68c7372a60ab4e331",
                    "0x00000000000000000000000000000000000000000000000000000000000003d5"
                ],
                "params": {
                    "from": "0x50d36f27872f637ec9ecb4eedff300df44a608ab",
                    "to": "0xfcbe7b6da18a08a86ab1beb68c7372a60ab4e331",
                    "tokenId": "981"
                },
                "data": "0x",
                "blockNumber": "17147007",
                "blockHash": "0x0af8cae4fce3cabdad9dbcac77ba4761afea961c040817ea835260ea6d56703a",
                "timeStamp": "1682713763",
                "gasPrice": "35684114147",
                "gasUsed": "267808",
                "logIndex": "250",
                "transactionHash": "0x0eb9b987533eee819a1509b5e50691438d0de6f9c43b46973fdd2516eccefd97",
                "transactionIndex": "98"
            },
            ...
           }
       ]
   }
}

ERC1155

/getbalance

Retrieves the number of NFTs held in the owner's account. Currently available on ethereum, polygon, BSC, and avalanche.

GET https://api.expand.network/nft/getbalance

Query Parameters

Name

Type

Description

https://api.expand.network/nft/getbalance?nftProtocolId=1155&nftCollection=0x6d4bbC0387dD4759EEe30f6A482AC6dC2Df3Facf&address=0x41e8BF3d9288EdDAcc3206f9aB21b61A1c59Df31&tokenId=1&chainId=1

{
    "status": 200,
    "msg": "success",
    "data": {
        "balance": "172"
    }
}

/historical/transactions

Retrieves past transactions associated with a designated address, sorted based on an NFT token contract, and limited within a specific block range. Currently available on ethereum.

GET https://api.expand.network/nft/historical/transactions

Query Parameters

https://api.expand.network/nft/historical/transactions?chainId=1&nftProtocolId=1155&startBlock=0&nftCollection=0x6Fc436606771bA2Cff576695FE9CA04D8D95d4ec&page=1&sort=desc

{
    "status": 200,
    "msg": "success",
    "data": {
        "transactions": [
            {
                "blockNumber": "17594313",
                "timeStamp": "1688155067",
                "hash": "0x8415c34fe5a21ed999b5deb2d82d24c92a579ac8201f0a74e69991bc88a2d1c2",
                "nonce": "71",
                "blockHash": "0x2925fc992c4239963b0a4af6d76221989f7df37ccc36fc8da502f5b7139d417e",
                "transactionIndex": "86",
                "gas": "77951",
                "gasPrice": "28151909699",
                "gasUsed": "72436",
                "cumulativeGasUsed": "12259715",
                "input": "deprecated",
                "contractAddress": "0x6fc436606771ba2cff576695fe9ca04d8d95d4ec",
                "from": "0xe4de48c4abc7e97c64cea4788edf1434e2463d93",
                "to": "0xfc40dcc9ab7dd6ffa62abd82ad7b913c180f08c5",
                "tokenID": "37",
                "tokenValue": "1",
                "tokenName": "EnigmaNFT1155",
                "tokenSymbol": "NFT1155",
                "confirmations": "1374518",
                "methodId": "0xf242432a",
                "methodSignature": "safeTransferFrom(address,address,uint256,uint256,bytes)"
            },
            ...
        ]
    }

/historical/logs

Retrieves historical logs for any nftCollection. Currently available on ethereum.

GET https://api.expand.network/nft/historical/logs

Query Parameters

https://api.expand.network/nft/historical/logs?nftCollection=0x6d4bbC0387dD4759EEe30f6A482AC6dC2Df3Facf&chainId=1&type=ApprovalForAll&nftProtocolId=1155&startBlock=17046490&endBlock=17151713

{
    "status": 200,
    "msg": "success",
    "data": {
        "logs": [
            {
                "address": "0x6d4bbc0387dd4759eee30f6a482ac6dc2df3facf",
                "topics": [
                    "0x17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31",
                    "0x0000000000000000000000004525aead5112662d8c117d1d27433bac9abc2029",
                    "0x0000000000000000000000004fee7b061c97c9c496b01dbce9cdb10c02f0a0be"
                ],
                "params": {},
                "data": "0x0000000000000000000000000000000000000000000000000000000000000001",
                "blockNumber": "17046490",
                "blockHash": "0x1b78ea8731de05cee7073e5d22c4b2196acbfbba3358677e593a43efd3c27664",
                "timeStamp": "1681488623",
                "gasPrice": "32423597367",
                "gasUsed": "46718",
                "logIndex": "300",
                "transactionHash": "0xf1558666d8a5ec595d6ef0431cc9e7801faf2b57671052e2c917019b9228b646",
                "transactionIndex": "144"
            },
          ]
        }
    }

Metaplex

NFTs for Solana

/getbalance

Retrieves the number of NFTs held in the owner's account.

GET https://api.expand.network/nft/getbalance

Query Parameters

Name

Type

Description

https://api.expand.network/nft/getbalance?nftCollection=4N9UeWZ3QVS4aK7R25CRRWYmJ8wnwUDRPYV6ScJetuME&chainId=900&address=8RNA1UbU2jA6aXsrcQLY3VxNBkyMUVmanWYFVmCwPYkB

{
    "status": 200,
    "msg": "success",
    "data": {
        "balance": 1
    }
}

/getmetadata

Retrieves the metadata for the specified NFT.

GET https://api.expand.network/nft/getmetadata

Query Parameters

https://api.expand.network/nft/getmetadata?chainId=900&nftCollection=8fGYVuiq5REaVwWTwatPvk342dm4xSY9ok2dE5rYEU5f

{
    "status": 200,
    "msg": "success",
    "data": {
        "name": "Crowdsurfers #1000",
        "symbol": "CROWD",
        "uri": "https://us-central1-simpl3r.cloudfunctions.net/m?id=8fGYVuiq5REaVwWTwatPvk342dm4xSY9ok2dE5rYEU5f&pid=eW6BNOjMgIFva6BNQ4Du"
    }
}

/getowner

Retrieves the owner for the specified NFT.

GET https://api.expand.network/nft/getowner

Query Parameters

https://api.expand.network/nft/getowner?chainId=900&nftCollection=8fGYVuiq5REaVwWTwatPvk342dm4xSY9ok2dE5rYEU5f

{
    "status": 200,
    "msg": "success",
    "data": {
        "owner": "98VK5fspL6j8837awbW5AB9dHbiLCoQQFziVejPKYnkG"
    }
}

ERC721

/getbalance

Retrieves the number of NFTs held in the owner's account. Currently available on Ethereum, Polygon, BSC, Avalanche, and zkSync.

GET https://api.expand.network/nft/getbalance

Query Parameters

Name

Type

Description

https://api.expand.network/nft/getbalance?nftCollection=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&address=0xc5c7b46843014B1591e9aF24de797156cde67f08

{
    "status": 200,
    "msg": "success",
    "data": {
        "balance": "2"
    }
}

/getmetadata

Retrieves the metadata for the specified NFT. Currently available on Ethereum, Polygon, BSC, Avalanche, and zkSync.

GET https://api.expand.network/nft/getmetadata

Query Parameters

Name

Type

Description

https://api.expand.network/nft/getmetadata?nftCollection=0x5af0d9827e0c53e4799bb226655a1de152a425a5

{
    "status": 200,
    "msg": "success",
    "data": {
        "name": "Milady",
        "symbol": "MIL"
    }
}

/getowner

Retrieves the owner of the specified token ID. Currently available on Ethereum, Polygon, BSC, Avalanche, and zkSync.

GET https://api.expand.network/nft/getowner

Query Parameters

Name

Type

Description

https://api.expand.network/nft/getowner?nftIndex=1000&nftCollection=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D

{
    "status": 200,
    "msg": "success",
    "data": {
        "owner": "0x68761dE35422d8e36d18dC2F7f6313a58c1a3616"
    }
}

/historical/transactions

Retrieves past transactions associated with a designated address, sorted based on an NFT token contract, and limited within a specific block range. Currently available on ethereum.

GET https://api.expand.network/nft/historical/transactions

Query Parameters

Name

Type

Description

https://api.expand.network/nft/historical/transactions?chainId=1&nftProtocolId=721&startBlock=0&nftCollection=0x306b1ea3ecdf94aB739F1910bbda052Ed4A9f949&page=1&sort=desc

{
    "status": 200,
    "msg": "success",
    "data": {
        "transactions": [
            {
                "blockNumber": "18968332",
                "timeStamp": "1704790283",
                "hash": "0x719286621b2b2e4aeda8e61a0ce2e58bd6f4806d1d411653172ec5380ec2c3d6",
                "nonce": "722",
                "blockHash": "0x6929852257b9d94b5f9b5908d851a25488d3a2afd11c103229f7a8fb305b5898",
                "from": "0x2efdb6dd6daa243fdf30cac2391adb8350d5e322",
                "contractAddress": "0x306b1ea3ecdf94ab739f1910bbda052ed4a9f949",
                "to": "0xae78174d3ab843dd349acb975ed1b3b1431a55e8",
                "tokenID": "769",
                "tokenName": "Beanz",
                "tokenSymbol": "BEANZ",
                "tokenDecimal": "0",
                "transactionIndex": "43",
                "gas": "173141",
                "gasPrice": "16138857662",
                "gasUsed": "128215",
                "cumulativeGasUsed": "9277786",
                "input": "deprecated",
                "confirmations": "513",
                "methodId": "0x00000000",
                "methodSignature": "get_block_hash_257335279069929(uint256)"
            },
            ...
        ]
    }
}

/historical/logs

Retrieves historical logs for any nftCollection. Currently available on ethereum.

GET https://api.expand.network/nft/historical/logs

Query Parameters

Name

Type

Description

https://api.expand.network/nft/historical/logs?chainId=1&nftCollection=0x08D7C0242953446436F34b4C78Fe9da38c73668d&type=Transfer&startBlock=17146713&endBlock=17157177

{
    "status": 200,
    "msg": "success",
    "data": {
        "logs": [
            {
                "address": "0x08d7c0242953446436f34b4c78fe9da38c73668d",
                "topics": [
                    "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
                    "0x00000000000000000000000050d36f27872f637ec9ecb4eedff300df44a608ab",
                    "0x000000000000000000000000fcbe7b6da18a08a86ab1beb68c7372a60ab4e331",
                    "0x00000000000000000000000000000000000000000000000000000000000003d5"
                ],
                "params": {
                    "from": "0x50d36f27872f637ec9ecb4eedff300df44a608ab",
                    "to": "0xfcbe7b6da18a08a86ab1beb68c7372a60ab4e331",
                    "tokenId": "981"
                },
                "data": "0x",
                "blockNumber": "17147007",
                "blockHash": "0x0af8cae4fce3cabdad9dbcac77ba4761afea961c040817ea835260ea6d56703a",
                "timeStamp": "1682713763",
                "gasPrice": "35684114147",
                "gasUsed": "267808",
                "logIndex": "250",
                "transactionHash": "0x0eb9b987533eee819a1509b5e50691438d0de6f9c43b46973fdd2516eccefd97",
                "transactionIndex": "98"
            },
            ...
           }
       ]
   }
}

Metaplex

NFTs for Solana

/getbalance

Retrieves the number of NFTs held in the owner's account.

GET https://api.expand.network/nft/getbalance

Query Parameters

Name

Type

Description

https://api.expand.network/nft/getbalance?nftCollection=4N9UeWZ3QVS4aK7R25CRRWYmJ8wnwUDRPYV6ScJetuME&chainId=900&address=8RNA1UbU2jA6aXsrcQLY3VxNBkyMUVmanWYFVmCwPYkB

{
    "status": 200,
    "msg": "success",
    "data": {
        "balance": 1
    }
}

/getmetadata

Retrieves the metadata for the specified NFT.

GET https://api.expand.network/nft/getmetadata

Query Parameters

Name

Type

Description

https://api.expand.network/nft/getmetadata?chainId=900&nftCollection=8fGYVuiq5REaVwWTwatPvk342dm4xSY9ok2dE5rYEU5f

{
    "status": 200,
    "msg": "success",
    "data": {
        "name": "Crowdsurfers #1000",
        "symbol": "CROWD",
        "uri": "https://us-central1-simpl3r.cloudfunctions.net/m?id=8fGYVuiq5REaVwWTwatPvk342dm4xSY9ok2dE5rYEU5f&pid=eW6BNOjMgIFva6BNQ4Du"
    }
}

/getowner

Retrieves the owner for the specified NFT.

GET https://api.expand.network/nft/getowner

Query Parameters

Name

Type

Description

https://api.expand.network/nft/getowner?chainId=900&nftCollection=8fGYVuiq5REaVwWTwatPvk342dm4xSY9ok2dE5rYEU5f

{
    "status": 200,
    "msg": "success",
    "data": {
        "owner": "98VK5fspL6j8837awbW5AB9dHbiLCoQQFziVejPKYnkG"
    }
}

ERC1155

/getbalance

Retrieves the number of NFTs held in the owner's account. Currently available on ethereum, polygon, BSC, and avalanche.

GET https://api.expand.network/nft/getbalance

Query Parameters

Name

Type

Description

https://api.expand.network/nft/getbalance?nftProtocolId=1155&nftCollection=0x6d4bbC0387dD4759EEe30f6A482AC6dC2Df3Facf&address=0x41e8BF3d9288EdDAcc3206f9aB21b61A1c59Df31&tokenId=1&chainId=1

{
    "status": 200,
    "msg": "success",
    "data": {
        "balance": "172"
    }
}

/historical/transactions

Retrieves past transactions associated with a designated address, sorted based on an NFT token contract, and limited within a specific block range. Currently available on ethereum.

GET https://api.expand.network/nft/historical/transactions

Query Parameters

Name

Type

Description

https://api.expand.network/nft/historical/transactions?chainId=1&nftProtocolId=1155&startBlock=0&nftCollection=0x6Fc436606771bA2Cff576695FE9CA04D8D95d4ec&page=1&sort=desc

{
    "status": 200,
    "msg": "success",
    "data": {
        "transactions": [
            {
                "blockNumber": "17594313",
                "timeStamp": "1688155067",
                "hash": "0x8415c34fe5a21ed999b5deb2d82d24c92a579ac8201f0a74e69991bc88a2d1c2",
                "nonce": "71",
                "blockHash": "0x2925fc992c4239963b0a4af6d76221989f7df37ccc36fc8da502f5b7139d417e",
                "transactionIndex": "86",
                "gas": "77951",
                "gasPrice": "28151909699",
                "gasUsed": "72436",
                "cumulativeGasUsed": "12259715",
                "input": "deprecated",
                "contractAddress": "0x6fc436606771ba2cff576695fe9ca04d8d95d4ec",
                "from": "0xe4de48c4abc7e97c64cea4788edf1434e2463d93",
                "to": "0xfc40dcc9ab7dd6ffa62abd82ad7b913c180f08c5",
                "tokenID": "37",
                "tokenValue": "1",
                "tokenName": "EnigmaNFT1155",
                "tokenSymbol": "NFT1155",
                "confirmations": "1374518",
                "methodId": "0xf242432a",
                "methodSignature": "safeTransferFrom(address,address,uint256,uint256,bytes)"
            },
            ...
        ]
    }

/historical/logs

Retrieves historical logs for any nftCollection. Currently available on ethereum.

GET https://api.expand.network/nft/historical/logs

Query Parameters

Name

Type

Description

https://api.expand.network/nft/historical/logs?nftCollection=0x6d4bbC0387dD4759EEe30f6A482AC6dC2Df3Facf&chainId=1&type=ApprovalForAll&nftProtocolId=1155&startBlock=17046490&endBlock=17151713

{
    "status": 200,
    "msg": "success",
    "data": {
        "logs": [
            {
                "address": "0x6d4bbc0387dd4759eee30f6a482ac6dc2df3facf",
                "topics": [
                    "0x17307eab39ab6107e8899845ad3d59bd9653f200f220920489ca2b5937696c31",
                    "0x0000000000000000000000004525aead5112662d8c117d1d27433bac9abc2029",
                    "0x0000000000000000000000004fee7b061c97c9c496b01dbce9cdb10c02f0a0be"
                ],
                "params": {},
                "data": "0x0000000000000000000000000000000000000000000000000000000000000001",
                "blockNumber": "17046490",
                "blockHash": "0x1b78ea8731de05cee7073e5d22c4b2196acbfbba3358677e593a43efd3c27664",
                "timeStamp": "1681488623",
                "gasPrice": "32423597367",
                "gasUsed": "46718",
                "logIndex": "300",
                "transactionHash": "0xf1558666d8a5ec595d6ef0431cc9e7801faf2b57671052e2c917019b9228b646",
                "transactionIndex": "144"
            },
          ]
        }
    }