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
rpc	String	Remote procedural call URL.
chainId	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details. Chain Symbols: eth, bsc, avax, matic.
nftCollection*	String	NFT collection address
address*	String	User's account address
nftProtocolId	String	721/1155 standard choice by default it is 721

Sample Request

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

Sample Response

{
    "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
rpc	String	Remote procedural call URL.
chainId	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details.
nftCollection*	String	NFT collection address.

Sample Request

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

Sample Response

{
    "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
rpc	String	Remote procedural call URL.
chainId	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details. Chain Symbols: eth, bsc, avax, matic.
nftCollection*	String	NFT collection address
nftProtocolId	String	721/1155 standard choice by default: 721
nftIndex*	String	Index of the nft in the Collection

Sample Request

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

Sample Response

{
    "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
rpc	String	Remote procedural call URL.
chainId	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details.
nftCollection*	String	NFT collection address
nftProtocolId	String	721/1155 standard choice by Default 721
startBlock	String	starting block of the range by Default: latestBlock -100
page	String	page no to get by Default 1
endBlock	String	end block of the range by Default: latestBlock
sort	String	asc/desc by Default desc

Sample Request

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

Sample Response

{
    "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
rpc	String	Remote procedural call URL.
chainId	String	Refer to the Chain ID page for details.
chainSymbol	String	Refer to the Chain ID page for details.
nftCollection*	String	NFT collection address
nftProtocolId	String	721/1155 standard choice by Default 721
startBlock	String	starting block of the range by Default: latestBlock -100
page	String	page no to get by Default 1
endBlock	String	end block of the range by Default: latestBlock
type*	String	ERC721: Approval, Transfer

Sample Request

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

Sample Response

{
    "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"
            },
            ...
           }
       ]
   }
}