# Wallet Balance

### Endpoint

`GET` /v1/wallets/token-balances

### Description

This API allows developers to check the token balance of multiple wallets of a specific contract address.

### Parameters

* `contract` (required): Contract address of the token.
* `chain` (required): The blockchain network the contract is deployed on. (1 for Ethereum, 56 for Binance Smart Chain, 137 for Polygon)
* `wallets` (required): A comma-separated list of wallet addresses.

### Headers

* x-api-key (required): A valid API key.

### Example

```rust
curl -X GET 'curl -X GET "https://api.lynxcrypto.app/v1/wallets/token-balances?contract=0x123456789abcdef&chain=1&wallets=0xabcdef123456789,0xabcdef123456789"'
-H 'x-api-key: <YOUR_API_KEY>'
```

### Response

```json
{
    "walletBalances": [
        {
            "walletAddress": "0x123456789abcdef",
            "balance": 1234.5678
        },
        {
            "walletAddress": "0xabcdef123456789",
            "balance": 2345.6789
        },
        ...
    ],
    "cumulativeBalance": 12345.678
}
```

### Response Codes

* `200`: Success. Returns the balance for the given wallets on the specified contract address and blockchain network.
* `400`: Bad Request. One of the required query string parameters (`contract`, `chain`, or `wallets`) is missing or invalid.
* `500`: Internal Server Error. An unexpected error occurred while processing the request.