Path Parameters

chainName

string

The blockchain name to query (e.g., base-mainnet, bsc-mainnet)

startDate

string

The start date for the block query in YYYY-MM-DD format

endDate

string

The end date for the block query in YYYY-MM-DD format

Query Parameters

page-size

integer

The number of results to return per page

page-number

integer

The page number to retrieve

Returns

data

object

The main response data object

updated_at

string

The timestamp indicating the last update time of the data

chain_id

integer

The unique identifier for the blockchain

chain_name

string

The name of the blockchain (e.g., 'base-mainnet')

items

array

The list of block items

block_hash

string

The unique hash of the block

signed_at

string

The timestamp when the block was signed

height

integer

The block height in the blockchain

block_parent_hash

string

The hash of the parent block

extra_data

string

The additional data stored in the block

miner_address

string

The address of the miner who mined the block

mining_cost

integer

The cost of mining the block

gas_used

integer

The gas used in the block

gas_limit

integer

The maximum gas limit for the block

transactions_link

string

The link to the transactions associated with the block

pagination

object

The pagination details for the response

has_more

boolean

The flag indicating if there are more pages of data

page_number

integer

The current page number

page_size

integer

The number of items per page

total_count

integer

The total number of items (nullable)

error

boolean

The flag indicating if an error occurred

error_message

string

The error message if an error occurred

error_code

integer

The error code if an error occurred

Request

1
curl --location 'https://api.covalenthq.com/v1/base-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/base-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/base-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/base-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/base-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/base-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/base-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/base-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

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free