> For the complete documentation index, see [llms.txt](https://ibvm.gitbook.io/ibvm-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ibvm.gitbook.io/ibvm-doc/explorer-documentation/tokens.md).

# Tokens

## Get ERC-20 Token CirculatingSupply by ContractAddress <a href="#get-bep-20-token-circulatingsupply-by-contractaddress" id="get-bep-20-token-circulatingsupply-by-contractaddress"></a>

Returns the current circulating supply of a ERC-20 token.

```
https://api.ibvmscan.io/api
   ?module=stats
   &action=tokenCsupply
   &contractaddress=0xe9e7cea3dedca5984780bafc599bd69add087d56
   &apikey=YourApiKeyToken
```

> Try this endpoint in your [**browser**](https://api.ibvmscan.io/api?module=stats\&action=tokenCsupply\&contractaddress=0xe9e7cea3dedca5984780bafc599bd69add087d56\&apikey=YourApiKeyToken) 🔗

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

| Parameter       | Description                                |
| --------------- | ------------------------------------------ |
| contractaddress | the `contract address` of the ERC-20 token |
| {% endtab %}    |                                            |

{% tab title="Response" %}
Sample response

```
{
   "status":"1",
   "message":"OK",
   "result":"4080173012393207910118532144"
}
```

{% hint style="info" %}
📈 **Tip** : The `result` is returned in the token's **smallest decimal representation.**

Eg. a token with a balance of `215.241526476136819398` and 18 decimal places will be returned as `215241526476136819398`&#x20;
{% endhint %}
{% endtab %}
{% endtabs %}

## Get ERC-20 Token TotalSupply by ContractAddress <a href="#get-bep-20-token-totalsupply-by-contractaddress" id="get-bep-20-token-totalsupply-by-contractaddress"></a>

Returns the total supply of a ERC-20 token.

```
https://api.ibvmscan.io/api
   ?module=stats
   &action=tokensupply
   &contractaddress=0xe9e7cea3dedca5984780bafc599bd69add087d56
   &apikey=YourApiKeyToken
```

> Try this endpoint in your [**browser**](https://api.ibvmscan.io/api?module=stats\&action=tokensupply\&contractaddress=0xe9e7cea3dedca5984780bafc599bd69add087d56\&apikey=YourApiKeyToken) 🔗

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

| Parameter       | Description                                |
| --------------- | ------------------------------------------ |
| contractaddress | the `contract address` of the ERC-20 token |
| {% endtab %}    |                                            |

{% tab title="Response" %}
Sample response

```
{
   "status":"1",
   "message":"OK",
   "result":"4200999399996203280118532144"
}
```

{% hint style="info" %}
📈 **Tip** : The `result` is returned in the token's **smallest decimal representation.**

Eg. a token with a balance of `215.241526476136819398` and 18 decimal places will be returned as `215241526476136819398`&#x20;
{% endhint %}
{% endtab %}
{% endtabs %}

## Get ERC-20 Token Account Balance by ContractAddress <a href="#get-bep-20-token-account-balance-by-contractaddress" id="get-bep-20-token-account-balance-by-contractaddress"></a>

Returns the current balance of a ERC-20 token of an address.

```
https://api.ibvmscan.io/api
   ?module=account
   &action=tokenbalance
   &contractaddress=0xe9e7cea3dedca5984780bafc599bd69add087d56
   &address=0x89e73303049ee32919903c09e8de5629b84f59eb
   &tag=latest
   &apikey=YourApiKeyToken
```

> Try this endpoint in your [**browser**](https://api.ibvmscan.io/api?module=account\&action=tokenbalance\&contractaddress=0xe9e7cea3dedca5984780bafc599bd69add087d56\&address=0x89e73303049ee32919903c09e8de5629b84f59eb\&tag=latest\&apikey=YourApiKeyToken) 🔗

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

| Parameter       | Description                                                      |
| --------------- | ---------------------------------------------------------------- |
| contractaddress | the `contract address` of the ERC-20 token                       |
| address         | the `string` representing the address to check for token balance |
| {% endtab %}    |                                                                  |

{% tab title="Response" %}
Sample response

```
{
   "status":"1",
   "message":"OK",
   "result":"1420514928941209"
}
```

{% hint style="info" %}
📈 **Tip** : The `result` is returned in the token's **smallest decimal representation.**

Eg. a token with a balance of `215.241526476136819398` and 18 decimal places will be returned as `215241526476136819398`&#x20;
{% endhint %}
{% endtab %}
{% endtabs %}