# ERC721

### /getbalance

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

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/nft/getbalance`

#### Query Parameters

| Name                                            | Type   | Description                                                                                                                 |
| ----------------------------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------- |
| rpc                                             | String | Remote procedural call URL.                                                                                                 |
| chainId                                         | String | Refer to the [Chain ID ](https://docs.expand.network/ids/chain-ids)page for details.                                        |
| chainSymbol                                     | String | <p>Refer to the <a href="../../ids/chain-ids">Chain ID </a>page for details. <br>Chain Symbols: eth, bsc, avax, matic. </p> |
| nftCollection<mark style="color:red;">\*</mark> | String | NFT collection address                                                                                                      |
| address<mark style="color:red;">\*</mark>       | String | User's account address                                                                                                      |
| nftProtocolId                                   | String | <p>721/1155 standard choice</p><p>by default it is 721</p>                                                                  |

{% tabs %}
{% tab title="Sample Request" %}

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

{% endtab %}

{% tab title="Sample Response" %}

<pre><code><strong>{
</strong>    "status": 200,
    "msg": "success",
    "data": {
        "balance": "2"
    }
}
</code></pre>

{% endtab %}
{% endtabs %}

### /getmetadata

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

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/nft/getmetadata`

#### Query Parameters

| Name                                            | Type   | Description                                                                          |
| ----------------------------------------------- | ------ | ------------------------------------------------------------------------------------ |
| rpc                                             | String | Remote procedural call URL.                                                          |
| chainId                                         | String | Refer to the [Chain ID ](https://docs.expand.network/ids/chain-ids)page for details. |
| chainSymbol                                     | String | Refer to the [Chain ID ](https://docs.expand.network/ids/chain-ids)page for details. |
| nftCollection<mark style="color:red;">\*</mark> | String | NFT collection address.                                                              |

{% tabs %}
{% tab title="Sample Request" %}

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

{% endtab %}

{% tab title="Sample Response" %}

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

{% endtab %}
{% endtabs %}

### /getowner

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

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/nft/getowner`

#### Query Parameters

| Name                                            | Type   | Description                                                                                                                   |
| ----------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------- |
| rpc                                             | String | Remote procedural call URL.                                                                                                   |
| chainId                                         | String | Refer to the [Chain ID ](https://docs.expand.network/ids/chain-ids)page for details.                                          |
| chainSymbol                                     | String | <p>Refer to the <a href="../../ids/chain-ids">Chain ID </a>page for details.</p><p>Chain Symbols: eth, bsc, avax, matic. </p> |
| nftCollection<mark style="color:red;">\*</mark> | String | NFT collection address                                                                                                        |
| nftProtocolId                                   | String | <p>721/1155 standard choice</p><p>by default: 721</p>                                                                         |
| nftIndex<mark style="color:red;">\*</mark>      | String | Index of the nft in the Collection                                                                                            |

{% tabs %}
{% tab title="Sample Request" %}

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

{% endtab %}

{% tab title="Sample Response" %}

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

{% endtab %}
{% endtabs %}

### /historicaltransactions

&#x20;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.

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/nft/historicaltransactions`

#### Query Parameters

| Name                                            | Type   | Description                                                                          |
| ----------------------------------------------- | ------ | ------------------------------------------------------------------------------------ |
| rpc                                             | String | Remote procedural call URL.                                                          |
| chainId                                         | String | Refer to the [Chain ID ](https://docs.expand.network/ids/chain-ids)page for details. |
| chainSymbol                                     | String | Refer to the [Chain ID ](https://docs.expand.network/ids/chain-ids)page for details. |
| nftCollection<mark style="color:red;">\*</mark> | String | NFT collection address                                                               |
| nftProtocolId                                   | String | <p>721/1155 standard choice</p><p>by Default 721</p>                                 |
| startBlock                                      | String | <p>starting block of the range</p><p>by Default: latestBlock -100</p>                |
| page                                            | String | <p>page no to get</p><p>by Default 1</p>                                             |
| endBlock                                        | String | <p>end block of the range</p><p>by Default: latestBlock</p>                          |
| sort                                            | String | <p>asc/desc</p><p>by Default  desc</p>                                               |

{% tabs %}
{% tab title="Sample Request " %}

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

{% endtab %}

{% tab title="Sample Response" %}

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

{% endtab %}
{% endtabs %}

### /historicallogs

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

<mark style="color:blue;">`GET`</mark> `https://api.expand.network/nft/historicallogs`

#### Query Parameters

| Name                                            | Type   | Description                                                                          |
| ----------------------------------------------- | ------ | ------------------------------------------------------------------------------------ |
| rpc                                             | String | Remote procedural call URL.                                                          |
| chainId                                         | String | Refer to the [Chain ID ](https://docs.expand.network/ids/chain-ids)page for details. |
| chainSymbol                                     | String | Refer to the [Chain ID ](https://docs.expand.network/ids/chain-ids)page for details. |
| nftCollection<mark style="color:red;">\*</mark> | String | NFT collection address                                                               |
| nftProtocolId                                   | String | <p>721/1155 standard choice</p><p>by Default 721</p>                                 |
| startBlock                                      | String | <p>starting block of the range</p><p>by Default: latestBlock -100</p>                |
| page                                            | String | <p>page no to get</p><p>by Default 1</p>                                             |
| endBlock                                        | String | <p>end block of the range</p><p>by Default: latestBlock</p>                          |
| type<mark style="color:red;">\*</mark>          | String | <p>ERC721: Approval, Transfer</p><p></p>                                             |

{% tabs %}
{% tab title="Sample Request " %}

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

{% endtab %}

{% tab title="Sample Response" %}

<pre class="language-json"><code class="lang-json"><strong>{
</strong>    "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"
            },
            ...
           }
       ]
   }
}
</code></pre>

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.expand.network/integrations/non-fungible-tokens/erc721.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.