v1/{chainName}/block_v2/{startDate}/{endDate}/ REST API Endpoint - GoldRush Wallet API

Path Parameters

chainName

string

Loading...

startDate

string

Loading...

endDate

string

Loading...

Query Parameters

page-size

integer

Loading...

page-number

integer

Loading...

Returns

data

object

Loading...

updated_at

string

Loading...

chain_id

integer

Loading...

chain_name

string

Loading...

items

array

Loading...

block_hash

string

Loading...

signed_at

string

Loading...

height

integer

Loading...

block_parent_hash

string

Loading...

extra_data

string

Loading...

miner_address

string

Loading...

mining_cost

integer

Loading...

gas_used

integer

Loading...

gas_limit

integer

Loading...

transactions_link

string

Loading...

pagination

object

Loading...

has_more

boolean

Loading...

page_number

integer

Loading...

page_size

integer

Loading...

total_count

integer

Loading...

error

boolean

Loading...

error_message

string

Loading...

error_code

integer

Loading...

Request

1
curl --location 'https://api.covalenthq.com/v1/eth-mainnet/block_v2/2023-01-01/2023-12-31/' \
2
--header 'Content-Type: application/json' \
3
--header 'Authorization: Bearer YOUR_API_KEY'

1
curl --location 'https://api.covalenthq.com/v1/eth-mainnet/block_v2/2023-01-01/2023-12-31/' \
2
--header 'Content-Type: application/json' \
3
--header 'Authorization: Bearer YOUR_API_KEY'

1
const myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3
myHeaders.append("Authorization", "Bearer YOUR_API_KEY");
4

5
const requestOptions = {
6
  method: "GET",
7
  headers: myHeaders,
8
  redirect: "follow"
9
};
10

11
fetch("https://api.covalenthq.com/v1/eth-mainnet/block_v2/2023-01-01/2023-12-31/", requestOptions)
12
  .then((response) => response.text())
13
  .then((result) => console.log(result))
14
  .catch((error) => console.error(error));

1
const myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3
myHeaders.append("Authorization", "Bearer YOUR_API_KEY");
4

5
const requestOptions = {
6
  method: "GET",
7
  headers: myHeaders,
8
  redirect: "follow"
9
};
10

11
fetch("https://api.covalenthq.com/v1/eth-mainnet/block_v2/2023-01-01/2023-12-31/", requestOptions)
12
  .then((response) => response.text())
13
  .then((result) => console.log(result))
14
  .catch((error) => console.error(error));

1
import requests
2
import json
3

4
url = "https://api.covalenthq.com/v1/eth-mainnet/block_v2/2023-01-01/2023-12-31/"
5

6
payload = {}
7
headers = {
8
  'Content-Type': 'application/json',
9
  'Authorization': 'Bearer YOUR_API_KEY'
10
}
11

12
response = requests.request("GET", url, headers=headers, data=payload)
13

14
print(response.text)
15

1
import requests
2
import json
3

4
url = "https://api.covalenthq.com/v1/eth-mainnet/block_v2/2023-01-01/2023-12-31/"
5

6
payload = {}
7
headers = {
8
  'Content-Type': 'application/json',
9
  'Authorization': 'Bearer YOUR_API_KEY'
10
}
11

12
response = requests.request("GET", url, headers=headers, data=payload)
13

14
print(response.text)
15

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://api.covalenthq.com/v1/eth-mainnet/block_v2/2023-01-01/2023-12-31/")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Get.new(url)
11
request["Content-Type"] = "application/json"
12
request["Authorization"] = "Bearer YOUR_API_KEY"
13

14
response = https.request(request)
15
puts response.read_body
16

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://api.covalenthq.com/v1/eth-mainnet/block_v2/2023-01-01/2023-12-31/")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Get.new(url)
11
request["Content-Type"] = "application/json"
12
request["Authorization"] = "Bearer YOUR_API_KEY"
13

14
response = https.request(request)
15
puts response.read_body
16

Response

1
{
2
  "data": {
3
    "updated_at": "2025-04-30T17:30:42Z",
4
    "chain_id": 1,
5
    "chain_name": "eth-mainnet",
6
    "items": [
7
      {
8
        "block_hash": "0x6540cf8572cafec8a69b57a5d5e93cfee21c30d548829b2c6a289bb315d31ab4",
9
        "signed_at": "2023-01-01T00:03:12Z",
10
        "height": 16308000,
11
        "block_parent_hash": "0x9b6a9a504f0a5adefa59e6d0a324df0b89ffa1b4a48f55b210835452573a1691",
12
        "extra_data": "0x6265617665726275696c642e6f7267",
13
        "miner_address": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
14
        "mining_cost": 246800000000,
15
        "gas_used": 12340000,
16
        "gas_limit": 15000000,
17
        "transactions_link": "https://api.covalenthq.com/v1/eth-mainnet/block_v2/16308000/transactions_v2/"
18
      },
19
      {
20
        "block_hash": "0x33e1cf4b1d4c6a8548bbd165a9016d6092de5fa3df71898dbc06f7ceef4b33a0",
21
        "signed_at": "2023-01-01T00:06:24Z",
22
        "height": 16308001,
23
        "block_parent_hash": "0x6540cf8572cafec8a69b57a5d5e93cfee21c30d548829b2c6a289bb315d31ab4",
24
        "extra_data": "0x466c6173682073796e63207061726974792e2052656365697665643a20312c204d69737365643a2030",
25
        "miner_address": "0x3ecef08d0e2dad803847e052249bb4f8bff2d5bb",
26
        "mining_cost": 234500000000,
27
        "gas_used": 11980000,
28
        "gas_limit": 15000000,
29
        "transactions_link": "https://api.covalenthq.com/v1/eth-mainnet/block_v2/16308001/transactions_v2/"
30
      },
31
      {
32
        "block_hash": "0x2a4b7d34b82a4f079c9a99095aa7c469746c3b0b5d02f7dae61d13ffc5348422",
33
        "signed_at": "2023-01-01T00:09:36Z",
34
        "height": 16308002,
35
        "block_parent_hash": "0x33e1cf4b1d4c6a8548bbd165a9016d6092de5fa3df71898dbc06f7ceef4b33a0",
36
        "extra_data": "0x48656c69617820762e312e302e30",
37
        "miner_address": "0x1ad91ee08f21be3de0ba2ba6918e714da6b45836",
38
        "mining_cost": 267300000000,
39
        "gas_used": 13650000,
40
        "gas_limit": 15000000,
41
        "transactions_link": "https://api.covalenthq.com/v1/eth-mainnet/block_v2/16308002/transactions_v2/"
42
      }
43
    ],
44
    "pagination": {
45
      "has_more": true,
46
      "page_number": 1,
47
      "page_size": 100,
48
      "total_count": 53348
49
    }
50
  },
51
  "error": false,
52
  "error_message": null,
53
  "error_code": null
54
}

1
{
2
  "data": {
3
    "updated_at": "2025-04-30T17:30:42Z",
4
    "chain_id": 1,
5
    "chain_name": "eth-mainnet",
6
    "items": [
7
      {
8
        "block_hash": "0x6540cf8572cafec8a69b57a5d5e93cfee21c30d548829b2c6a289bb315d31ab4",
9
        "signed_at": "2023-01-01T00:03:12Z",
10
        "height": 16308000,
11
        "block_parent_hash": "0x9b6a9a504f0a5adefa59e6d0a324df0b89ffa1b4a48f55b210835452573a1691",
12
        "extra_data": "0x6265617665726275696c642e6f7267",
13
        "miner_address": "0xea674fdde714fd979de3edf0f56aa9716b898ec8",
14
        "mining_cost": 246800000000,
15
        "gas_used": 12340000,
16
        "gas_limit": 15000000,
17
        "transactions_link": "https://api.covalenthq.com/v1/eth-mainnet/block_v2/16308000/transactions_v2/"
18
      },
19
      {
20
        "block_hash": "0x33e1cf4b1d4c6a8548bbd165a9016d6092de5fa3df71898dbc06f7ceef4b33a0",
21
        "signed_at": "2023-01-01T00:06:24Z",
22
        "height": 16308001,
23
        "block_parent_hash": "0x6540cf8572cafec8a69b57a5d5e93cfee21c30d548829b2c6a289bb315d31ab4",
24
        "extra_data": "0x466c6173682073796e63207061726974792e2052656365697665643a20312c204d69737365643a2030",
25
        "miner_address": "0x3ecef08d0e2dad803847e052249bb4f8bff2d5bb",
26
        "mining_cost": 234500000000,
27
        "gas_used": 11980000,
28
        "gas_limit": 15000000,
29
        "transactions_link": "https://api.covalenthq.com/v1/eth-mainnet/block_v2/16308001/transactions_v2/"
30
      },
31
      {
32
        "block_hash": "0x2a4b7d34b82a4f079c9a99095aa7c469746c3b0b5d02f7dae61d13ffc5348422",
33
        "signed_at": "2023-01-01T00:09:36Z",
34
        "height": 16308002,
35
        "block_parent_hash": "0x33e1cf4b1d4c6a8548bbd165a9016d6092de5fa3df71898dbc06f7ceef4b33a0",
36
        "extra_data": "0x48656c69617820762e312e302e30",
37
        "miner_address": "0x1ad91ee08f21be3de0ba2ba6918e714da6b45836",
38
        "mining_cost": 267300000000,
39
        "gas_used": 13650000,
40
        "gas_limit": 15000000,
41
        "transactions_link": "https://api.covalenthq.com/v1/eth-mainnet/block_v2/16308002/transactions_v2/"
42
      }
43
    ],
44
    "pagination": {
45
      "has_more": true,
46
      "page_number": 1,
47
      "page_size": 100,
48
      "total_count": 53348
49
    }
50
  },
51
  "error": false,
52
  "error_message": null,
53
  "error_code": null
54
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free