# Get NFT Balance

{% hint style="info" %}
Retrieves the NFT balance for a specified PLYR ID on a specific chain.
{% endhint %}

**Endpoint:** `/game/nft/balance`\
**Method:** GET

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

```typescript
{
    plyrId: string;      // The PLYR ID of the user
    chainId?: string;    // Optional chain ID
}
```

{% endtab %}

{% tab title="Success Response" %}

```typescript
{
	balance: string; // The number of NFTs owned by the user
}
```

{% endtab %}

{% tab title="Error Response" %}

```typescript
{
  error: string;
  details?: any;
}
```

{% endtab %}
{% endtabs %}

## Example Usage

```javascript
// Setup request parameters
const timestamp = Date.now().toString();
const plyrId = 'player123';
const chainId = '43114'; // Avalanche C-Chain

// For GET requests with no body, pass null as the body for HMAC
const hmac = generateHmacSignature(timestamp, null, secretKey);

// Make the API request
const response = await axios.get(apiEndpoint + `/game/nft/balance?plyrId=${plyrId}&chainId=${chainId}`, {
	headers: {
		apikey: apiKey,
		signature: hmac,
		timestamp: timestamp
	}
});

// Process the response
console.log(`User's NFT balance: ${response.data.balance}`);
```