# getErc20TokensByWalletAddress

### Description

Retrieves ERC20 token balances for a specific wallet address on the specified blockchain network. This endpoint returns detailed balance information including token metadata, exchange rates, and USD valuations when available.

**Filtering Options:**

* Query specific tokens by contract address
* Show all tokens or only those with non-zero balances
* Include or exclude potential spam/scam tokens

{% code overflow="wrap" %}

```javascript
public getErc20TokensByWalletAddress(chain: VyChain, walletAddress: string, query?: VyQuery_GetErc20TokensByWalletAddress) : VyPromise<VyErc20TokenDto[]>
```

{% endcode %}

{% tabs %}
{% tab title="Details" %}
**Parameters**

| chain            | [VyChain](/sdk-reference/ts-js-v3/object-references/enum/vychain.md)                                                                        | Blockchain network on which to query token balances  |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| walletAddress    | string                                                                                                                                      | The address of the wallet to fetch token balance for |
| query (optional) | [VyQuery\_GetErc20TokensByWalletAddress](/sdk-reference/ts-js-v3/object-references/wallet/queries/vyquery_geterc20tokensbywalletaddress.md) | Query to filter the operation results                |

**Returns**

VyPromise<[VyErc20TokenDto](/sdk-reference/ts-js-v3/object-references/wallet/vyerc20tokendto.md)\[]>\
ERC20 token balance of wallet retrieved successfully.
{% 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://sdk.venly.io/sdk-reference/ts-js-v3/function-references/wallet/balance/geterc20tokensbywalletaddress.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.