# 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 ](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.                                                              |
| 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 ](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?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 ](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/getowner?chainId=900&nftCollection=8fGYVuiq5REaVwWTwatPvk342dm4xSY9ok2dE5rYEU5f
```

{% endtab %}

{% tab title="Sample Response" %}

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

{% endtab %}
{% endtabs %}