# 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 %}