> For the complete documentation index, see [llms.txt](https://docs.expand.network/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.expand.network/integrations/non-fungible-tokens/metaplex.md).

# Metaplex

### /getbalance

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

<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 ](/ids/chain-ids.md)page for details. |
| chainSymbol                                     | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details. |
| nftCollection<mark style="color:red;">\*</mark> | String | NFT collection address.                                      |
| address<mark style="color:red;">\*</mark>       | String | User's account address.                                      |

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

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

{% endtab %}

{% tab title="Sample Response" %}

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

{% endtab %}
{% endtabs %}

### /getmetadata

Retrieves the metadata for the specified NFT.

<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 ](/ids/chain-ids.md)page for details. |
| chainSymbol                                     | String | Refer to the [Chain ID ](/ids/chain-ids.md)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?chainId=900&nftCollection=8fGYVuiq5REaVwWTwatPvk342dm4xSY9ok2dE5rYEU5f
```

{% endtab %}

{% tab title="Sample Response" %}

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

{% endtab %}
{% endtabs %}

### /getowner

Retrieves the owner for the specified NFT.

<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 ](/ids/chain-ids.md)page for details. |
| chainSymbol                                     | String | Refer to the [Chain ID ](/ids/chain-ids.md)page for details. |
| nftCollection<mark style="color:red;">\*</mark> | String | NFT collection address.                                      |

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

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

{% endtab %}

{% tab title="Sample Response" %}

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

{% endtab %}
{% endtabs %}