# Stats

## Get Total Supply of XDC

Returns the current amount of Ether in circulation excluding ETH2 Staking rewards and EIP1559 burnt fees.

```
https://api.xdcscan.io/api
   ?module=stats
   &action=ethsupply
   &apikey=YourApiKeyToken
```

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=stats\&action=ethsupply\&apikey=YourApiKeyToken) :link:

{% tabs %}
{% tab title="Request" %}
No parameters required.
{% endtab %}

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

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

{% hint style="info" %}
:book: **Tip :** Easily convert XDC units using our [**unit converter.**](https://xdc.blocksscan.io/unitconverter)
{% endhint %}
{% endtab %}
{% endtabs %}

## Get XDC Last Price

Returns the latest price of 1 XDC.

```
https://api.xdcscan.io/api
   ?module=stats
   &action=xdcprice
   &apikey=YourApiKeyToken
```

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=stats\&action=xdcprice\&apikey=YourApiKeyToken) :link:

{% tabs %}
{% tab title="Request" %}
No parameters required.
{% endtab %}

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

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

```

{% hint style="info" %}
:hourglass\_flowing\_sand: **Tip :** The `timestamps` are represented in [**Unix timestamp.**](https://www.unixtimestamp.com/)
{% endhint %}
{% endtab %}
{% endtabs %}

## Get XDC Nodes Size ***(Coming Soon)***

Returns the size of the XDC blockchain, in bytes, over a date range.

```
https://api.xdcscan.io/api
   ?module=stats
   &action=chainsize
   &startdate=2024-08-10
   &enddate=2024-08-15
   &clienttype=geth
   &syncmode=default
   &sort=asc
   &apikey=YourApiKeyToken
```

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=stats\&action=chainsize\&startdate=2024-08-10\&enddate=2024-08-15\&clienttype=geth\&syncmode=default\&sort=asc\&apikey=YourApiKeyToken) :link:

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

| Parameter    | Description                                                                             |
| ------------ | --------------------------------------------------------------------------------------- |
| startdate    | the starting date in `yyyy-MM-dd` format, eg. `2019-06-01`                              |
| enddate      | the ending date in `yyyy-MM-dd` format, eg. `2024-07-10`                                |
| clienttype   | the XDC \[node client] to use, either `geth` or `parity`                                |
| syncmode     | the \[type of node] to run, either `default` or `archive`                               |
| sort         | the sorting preference, use `asc` to sort by ascending and `desc` to sort by descending |
| {% endtab %} |                                                                                         |

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

```
{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "blockNumber":"7156164",
         "chainTimeStamp":"2019-02-01",
         "chainSize":"184726421279",
         "clientType":"Geth",
         "syncMode":"Default"
      }
      {
         "blockNumber":"7276521",
         "chainTimeStamp":"2019-02-28",
         "chainSize":"197073145113",
         "clientType":"Geth",
         "syncMode":"Default"
      }
   ]
}
```

{% hint style="info" %}
:chains: **Tip :** The `chainSize` is represented in **bytes.**
{% endhint %}
{% endtab %}
{% endtabs %}

## Get Total Nodes Count

Returns the total number of discoverable XDC nodes.

```
https://api.xdcscan.io/api
   ?module=stats
   &action=nodecount
   &apikey=YourApiKeyToken
```

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=stats\&action=nodecount\&apikey=YourApiKeyToken) :link:

{% tabs %}
{% tab title="Request" %}
No parameters required.
{% endtab %}

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

```
{
   "status":"1",
   "message":"OK",
   "result":{
      "UTCDate":"2021-06-29",
      "TotalNodeCount":"6413"
   }
}
```

{% endtab %}
{% endtabs %}

## Get Daily Network Transaction Fee <img src="https://github.com/BlocksScan/Docs/blob/api/broken-reference" alt="" data-size="line">

Returns the amount of transaction fees paid to miners per day.

```
https://api.xdcscan.io/api
   ?module=stats
   &action=dailytxnfee
   &startdate=2024-08-10
   &enddate=2024-08-15
   &sort=asc
   &apikey=YourApiKeyToken 
```

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=stats\&action=dailytxnfee\&startdate=2024-08-10\&enddate=2024-08-15\&sort=asc\&apikey=YourApiKeyToken) :link:

{% tabs %}
{% tab title="Request" %}
No parameters required.
{% endtab %}

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

```
{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "UTCDate":"2019-02-01",
         "unixTimeStamp":"1548979200",
         "transactionFee_Eth":"358.558440870590355682"
      }
      {
         "UTCDate":"2019-02-28",
         "unixTimeStamp":"1551312000",
         "transactionFee_Eth":"545.141762162356907132"
      }
   ]
}
```

{% endtab %}
{% endtabs %}

## Get Daily New Address Count<img src="https://github.com/BlocksScan/Docs/blob/api/broken-reference" alt="" data-size="line">

Returns the number of new XDC addresses created per day.

```
https://api.xdcscan.io/api
   ?module=stats
   &action=dailynewaddress
   &startdate=2024-08-10
   &enddate=2024-08-15
   &sort=asc
   &apikey=YourApiKeyToken 
```

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=stats\&action=dailynewaddress\&startdate=2024-08-10\&enddate=2024-08-15\&sort=asc\&apikey=YourApiKeyToken) :link:

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

| Parameter    | Description                                                                             |
| ------------ | --------------------------------------------------------------------------------------- |
| startdate    | the starting date in `yyyy-MM-dd` format, eg. `2019-02-01`                              |
| enddate      | the ending date in `yyyy-MM-dd` format, eg. `2019-02-28`                                |
| sort         | the sorting preference, use `asc` to sort by ascending and `desc` to sort by descending |
| {% endtab %} |                                                                                         |

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

```
{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "UTCDate":"2019-02-01",
         "unixTimeStamp":"1548979200",
         "newAddressCount":54081
      },
      {
         "UTCDate":"2019-02-28",
         "unixTimeStamp":"1551312000",
         "newAddressCount":53117
      }
   ]
}
```

{% endtab %}
{% endtabs %}

## Get Daily Network Utilization <img src="https://github.com/BlocksScan/Docs/blob/api/broken-reference" alt="" data-size="line">

Returns the daily average gas used over gas limit, in percentage.

```
https://api.xdcscan.io/api
   ?module=stats
   &action=dailynetutilization
   &startdate=2024-08-10
   &enddate=2024-08-15
   &sort=asc
   &apikey=YourApiKeyToken 
```

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=stats\&action=dailynetutilization\&startdate=2024-08-10\&enddate=2024-08-15\&sort=asc\&apikey=YourApiKeyToken) :link:

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

| Parameter    | Description                                                                             |
| ------------ | --------------------------------------------------------------------------------------- |
| startdate    | the starting date in `yyyy-MM-dd` format, eg. `2019-02-01`                              |
| enddate      | the ending date in `yyyy-MM-dd` format, eg. `2019-02-28`                                |
| sort         | the sorting preference, use `asc` to sort by ascending and `desc` to sort by descending |
| {% endtab %} |                                                                                         |

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

```
{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "UTCDate":"2019-02-01",
         "unixTimeStamp":"1548979200",
         "networkUtilization":"0.8464"
      },
      {
         "UTCDate":"2019-02-28",
         "unixTimeStamp":"1551312000",
         "networkUtilization":"0.9472"
      }
   ]
}
```

{% endtab %}
{% endtabs %}

## Get Daily Average Network Hash Rate ***(Coming Soon)***<img src="https://github.com/BlocksScan/Docs/blob/api/broken-reference" alt="" data-size="line">

Returns the historical measure of processing power of the XDC network.

```
https://api.xdcscan.io/api
   ?module=stats
   &action=dailyavghashrate
   &startdate=2024-08-10
   &enddate=2024-08-15
   &sort=asc
   &apikey=YourApiKeyToken 
```

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=stats\&action=dailyavghashrate\&startdate=2024-08-10\&enddate=2024-08-15\&sort=asc\&apikey=YourApiKeyToken) :link:

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

| Parameter    | Description                                                                             |
| ------------ | --------------------------------------------------------------------------------------- |
| startdate    | the starting date in `yyyy-MM-dd` format, eg. `2019-02-01`                              |
| enddate      | the ending date in `yyyy-MM-dd` format, eg. `2019-02-28`                                |
| sort         | the sorting preference, use `asc` to sort by ascending and `desc` to sort by descending |
| {% endtab %} |                                                                                         |

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

```
{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "UTCDate":"2019-02-01",
         "unixTimeStamp":"1548979200",
         "networkHashRate":"143116.0140"
      },
      {
         "UTCDate":"2019-02-28",
         "unixTimeStamp":"1551312000",
         "networkHashRate":"157689.3983"
      }
   ]
}
```

{% hint style="info" %}
:fire: **Tip :** The `networkHashRate` is represented in [**GigaHashes ( GH/s )**](https://coinguides.org/hashpower-converter-calculator/)**.**
{% endhint %}
{% endtab %}
{% endtabs %}

## Get Daily Transaction Count <img src="https://github.com/BlocksScan/Docs/blob/api/broken-reference" alt="" data-size="line">

Returns the number of transactions performed on the XDC blockchain per day.

```
https://api.xdcscan.io/api
   ?module=stats
   &action=dailytx
   &startdate=2024-08-10
   &enddate=2024-08-15
   &sort=asc
   &apikey=YourApiKeyToken 
```

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=stats\&action=dailytx\&startdate=2024-08-10\&enddate=2024-08-15\&sort=asc\&apikey=YourApiKeyToken) :link:

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

| Parameter    | Description                                                                             |
| ------------ | --------------------------------------------------------------------------------------- |
| startdate    | the starting date in `yyyy-MM-dd` format, eg. `2019-02-01`                              |
| enddate      | the ending date in `yyyy-MM-dd` format, eg. `2019-02-28`                                |
| sort         | the sorting preference, use `asc` to sort by ascending and `desc` to sort by descending |
| {% endtab %} |                                                                                         |

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

```
{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "UTCDate":"2019-02-01",
         "unixTimeStamp":"1548979200",
         "transactionCount":498856
      },
      {
         "UTCDate":"2019-02-28",
         "unixTimeStamp":"1551312000",
         "transactionCount":541458
      }
   ]
}
```

{% endtab %}
{% endtabs %}

## Get Daily Average Network Difficulty ***(Coming Soon)***<img src="https://github.com/BlocksScan/Docs/blob/api/broken-reference" alt="" data-size="line">

Returns the historical mining difficulty of the XDC network.

```
https://api.xdcscan.io/api
   ?module=stats
   &action=dailyavgnetdifficulty
   &startdate=2024-08-10
   &enddate=2024-08-15
   &sort=asc
   &apikey=YourApiKeyToken 
```

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=stats\&action=dailyavgnetdifficulty\&startdate=2024-08-10\&enddate=2024-08-15\&sort=asc\&apikey=YourApiKeyToken) :link:

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

| Parameter    | Description                                                                             |
| ------------ | --------------------------------------------------------------------------------------- |
| startdate    | the starting date in `yyyy-MM-dd` format, eg. `2019-02-01`                              |
| enddate      | the ending date in `yyyy-MM-dd` format, eg. `2019-02-28`                                |
| sort         | the sorting preference, use `asc` to sort by ascending and `desc` to sort by descending |
| {% endtab %} |                                                                                         |

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

```
{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "UTCDate":"2019-02-01",
         "unixTimeStamp":"1548979200",
         "networkDifficulty":"2,408.028"
      },
      {
         "UTCDate":"2019-02-28",
         "unixTimeStamp":"1551312000",
         "networkDifficulty":"2,927.453"
      }
   ]
}
```

{% hint style="info" %}
**​**​ :fire: **Tip :** The `networkDifficulty` is represented in [**TeraHashes ( TH/s )**](https://coinguides.org/hashpower-converter-calculator/)**.**
{% endhint %}
{% endtab %}
{% endtabs %}

## Get XDC Historical Daily Market Cap <img src="https://github.com/BlocksScan/Docs/blob/api/broken-reference" alt="" data-size="line">

Returns the historical XDC daily market capitalization.

```
https://api.xdcscan.io/api
   ?module=stats
   &action=xdcdailymarketcap
   &startdate=2024-08-10
   &enddate=2024-08-15
   &sort=asc
   &apikey=YourApiKeyToken 
```

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=stats\&action=xdcdailymarketcap\&startdate=2024-08-10\&enddate=2024-08-15\&sort=asc\&apikey=YourApiKeyToken) :link:

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

| Parameter    | Description                                                                             |
| ------------ | --------------------------------------------------------------------------------------- |
| startdate    | the starting date in `yyyy-MM-dd` format, eg. `2019-02-01`                              |
| enddate      | the ending date in `yyyy-MM-dd` format, eg. `2019-02-28`                                |
| sort         | the sorting preference, use `asc` to sort by ascending and `desc` to sort by descending |
| {% endtab %} |                                                                                         |

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

```
{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "UTCDate":"2019-02-01",
         "unixTimeStamp":"1548979200",
         "supply":"104672819.281250",
         "marketCap":"11203.1318476721875",
         "price":"107.03"
      },
      {
         "UTCDate":"2019-02-28",
         "unixTimeStamp":"1551312000",
         "supply":"105048576.406250",
         "marketCap":"14317.0704784078125",
         "price":"136.29"
      }
   ]
}
```

{% hint style="info" %}
**​**​ :moneybag: **Tip :** The `marketCap` is represented in [**m**](https://coinguides.org/hashpower-converter-calculator/)**illion US Dollars ( USD ).**
{% endhint %}
{% endtab %}
{% endtabs %}

## Get XDC Historical Price <img src="https://github.com/BlocksScan/Docs/blob/api/broken-reference" alt="" data-size="line">

Returns the historical price of 1 XDC.

```
https://api.xdcscan.io/api
   ?module=stats
   &action=xdcdailyprice
   &startdate=2024-08-10
   &enddate=2024-08-10
   &sort=asc
   &apikey=YourApiKeyToken 
```

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=stats\&action=xdcdailyprice\&startdate=2024-08-10\&enddate=2024-08-15\&sort=asc\&apikey=YourApiKeyToken) :link:

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

| Parameter    | Description                                                                             |
| ------------ | --------------------------------------------------------------------------------------- |
| startdate    | the starting date in `yyyy-MM-dd` format, eg. `2019-02-01`                              |
| enddate      | the ending date in `yyyy-MM-dd` format, eg. `2019-02-28`                                |
| sort         | the sorting preference, use `asc` to sort by ascending and `desc` to sort by descending |
| {% endtab %} |                                                                                         |

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

```
{
   "status":"1",
   "message":"OK",
   "result":[
      {
         "UTCDate":"2019-02-01",
         "unixTimeStamp":"1548979200",
         "value":"107.03"
      },
      {
         "UTCDate":"2019-02-28",
         "unixTimeStamp":"1551312000",
         "value":"136.29"
      }
   ]
}
```

{% hint style="info" %}
**​**​ :moneybag: **Tip :** The `value` is represented in **US Dollars ( USD ).**
{% endhint %}
{% 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://docs.blocksscan.io/api-endpoints/stats.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.