# Blocks (WIP)

## Get Block And Uncle Rewards by BlockNo (WIP)

Returns the block reward and 'Uncle' block rewards.

```
https://api.xdcscan.io/api
   ?module=block
   &action=getblockreward
   &blockno=2165403
```

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=block\&action=getblockreward\&blockno=2165403) :link:

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

| Parameter    | Description                                                                                                      |
| ------------ | ---------------------------------------------------------------------------------------------------------------- |
| blockno      | the `integer` block number to check block rewards for eg. [`76986383`](https://xdc.blocksscan.io/block/76986383) |
| {% endtab %} |                                                                                                                  |

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

```
{
  "status": 0,
  "message": "OK",
  "result": {
    "blockReward": 0.3375,
    "blockNumber": 2165403,
    "timeStamp": 1563977473,
    "blockMiner": "xdc0000000000000000000000000000000000000000"
  }
}
```

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

## Get Estimated Block Countdown Time by BlockNo (WIP)

Returns the estimated time remaining, in seconds, until a certain block is mined.

```
https://api.xdcscan.io/api
   ?module=block
   &action=getblockcountdown
   &blockno=16701588
   &apikey=YourApiKeyToken
```

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

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

| Parameter    | Description                                                                                                               |
| ------------ | ------------------------------------------------------------------------------------------------------------------------- |
| blockno      | the `integer` block number to estimate time remaining to be mined eg. [`76986383`](https://api.xdcscan.io/block/76986383) |
| {% endtab %} |                                                                                                                           |

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

```
{
   "status":"1",
   "message":"OK",
   "result":{
      "CurrentBlock":"12715477",
      "CountdownBlock":"16701588",
      "RemainingBlock":"3986111",
      "EstimateTimeInSec":"52616680.2"
   }
}
```

{% endtab %}
{% endtabs %}

## Get Block Number by Timestamp (WIP)

Returns the block number that was mined at a certain timestamp.

```
https://api.xdcscan.io/api
   ?module=block
   &action=getblocknobytime
   &timestamp=1720632212
   &closest=before
   &apikey=YourApiKeyToken
```

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=block\&action=getblocknobytime\&timestamp=1720632212\&closest=before\&apikey=YourApiKeyToken) :link:

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

| Parameter    | Description                                                                       |
| ------------ | --------------------------------------------------------------------------------- |
| timestamp    | the `integer` representing the Unix timestamp in **seconds**.                     |
| closest      | the closest available block to the provided timestamp, either `before` or `after` |
| {% endtab %} |                                                                                   |

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

```
{
"message": "Invalid `timestamp` param",
"result": null,
"status": "0"
}
```

{% hint style="info" %}
:hourglass\_flowing\_sand: **Tip :** Convert a regular date-time to a [**Unix timestamp.**](https://www.unixtimestamp.com/)
{% endhint %}
{% endtab %}
{% endtabs %}

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

Returns the daily average block size within a date range.

```
https://api.xdcscan.io/api
   ?module=stats
   &action=dailyavgblocksize
   &startdate=2019-02-01
   &enddate=2019-02-28
   &sort=asc
   &apikey=YourApiKeyToken
```

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=stats\&action=dailyavgblocksize\&startdate=2019-02-01\&enddate=2019-02-28\&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",
         "blockSize_bytes":20373
      },
      {
         "UTCDate":"2019-02-28",
         "unixTimeStamp":"1551312000",
         "blockSize_bytes":25117
      }
   ]
}
```

{% endtab %}
{% endtabs %}

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

Returns the number of blocks mined daily and the amount of block rewards.

```
https://api.xdcscan.io/api
   ?module=stats
   &action=dailyblkcount
   &startdate=2019-02-01
   &enddate=2019-02-28
   &sort=asc
   &apikey=YourApiKeyToken 
```

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=stats\&action=dailyblkcount\&startdate=2019-02-01\&enddate=2019-02-28\&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",
         "blockCount":4848,
         "blockRewards_Eth":"14929.464690870590355682"
      },
      {
         "UTCDate":"2019-02-28",
         "unixTimeStamp":"1551312000",
         "blockCount":4366,
         "blockRewards_Eth":"12808.485512162356907132"
      }
   ]
}
```

{% endtab %}
{% endtabs %}

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

Returns the amount of block rewards distributed to miners daily.

```
https://api.xdcscan.io/api
   ?module=stats
   &action=dailyblockrewards
   &startdate=2019-02-01
   &enddate=2019-02-28
   &sort=asc
   &apikey=YourApiKeyToken 
```

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=stats\&action=dailyblockrewards\&startdate=2019-02-01\&enddate=2019-02-28\&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",
         "blockRewards_Eth":"15300.65625"
      },
      {
         "UTCDate":"2019-02-28",
         "unixTimeStamp":"1551312000",
         "blockRewards_Eth":"12954.84375"
      }
   ]
}
```

{% endtab %}
{% endtabs %}

## Get Daily Average Time for A Block to be Included in the XDC Blockchain ***(Coming Soon)***<img src="https://github.com/BlocksScan/Docs/blob/api/broken-reference" alt="" data-size="line">

Returns the daily average of time needed for a block to be successfully mined.

```
https://api.xdcscan.io/api
   ?module=stats
   &action=dailyavgblocktime
   &startdate=2019-02-01
   &enddate=2019-02-28
   &sort=asc
   &apikey=YourApiKeyToken 
```

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=stats\&action=dailyavgblocktime\&startdate=2019-02-01\&enddate=2019-02-28\&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",
         "blockTime_sec":"17.67"
      },
      {
         "UTCDate":"2019-02-28",
         "unixTimeStamp":"1551312000",
         "blockTime_sec":"19.61"
      }
   ]
}
```

{% endtab %}
{% endtabs %}

## Get Daily Uncle Block Count and Rewards ***(Coming Soon)***<img src="https://github.com/BlocksScan/Docs/blob/api/broken-reference" alt="" data-size="line">

Returns the number of 'Uncle' blocks mined daily and the amount of 'Uncle' block rewards.

```
https://api.xdcscan.io/api
   ?module=stats
   &action=dailyuncleblkcount
   &startdate=2019-02-01
   &enddate=2019-02-28
   &sort=asc
   &apikey=YourApiKeyToken 
```

> Try this endpoint in your [**browser**](https://api.xdcscan.io/api?module=stats\&action=dailyuncleblkcount\&startdate=2019-02-01\&enddate=2019-02-28\&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 %}  |                                                                                         |
| {% endtabs %} |                                                                                         |