Get Blocks by Number

This endpoint returns all Blocks that were mined within a given block number range (supports pagination). Supported chains: ethereum, polygon, optimism, scroll, arbitrum, base, avalanche.

Parameters

Parameter	Description	Type
chain_id	A keyword (i.e. "ethereum") or CAIP-2 identifier specifying the blockchain to query.	string
block_number_above	The earlier block number, inclusive.	integer
block_number_below	The later block number, inclusive.	integer
order	The order in which to retrieve the results (either asc or desc).	string
limit	The maximum number of results to retrieve (default 100).	string

PythonNodecURL

import requests url = "https://api.transpose.io/block/blocks-by-number" headers = { 'Content-Type': 'application/json', 'X-API-KEY': 'BtRVYj7dgnYUcr1gSSfWhmrTShIb8RBG', } params = { "chain_id": "ethereum", "limit": "1", } response = requests.get(url, headers=headers, params=params) print(response.text) print('Credits charged:', response.headers.get('X-Credits-Charged', None))

const https = require('https'); const querystring = require('querystring'); const params = { chain_id: "ethereum", limit: "1", } var options = { hostname: 'api.transpose.io', path: '/block/blocks-by-number?' + querystring.stringify(params), method: 'GET', headers: { 'X-API-KEY': 'BtRVYj7dgnYUcr1gSSfWhmrTShIb8RBG' } }; var req = https.request(options, (res) => { console.log('Credits charged:', res.headers['x-credits-charged']); res.on('data', (d) => { process.stdout.write(d); }); }); req.on('error', (e) => { console.error(e); }); req.end();

curl -X GET \
    'https://api.transpose.io/block/blocks-by-number?chain_id=ethereum&limit=1' \
    -H 'X-API-KEY: BtRVYj7dgnYUcr1gSSfWhmrTShIb8RBG' \

Got questions? Join our Discord

Discord is the primary home of the Transpose developer community. Join us to ask questions, share your work, and get help.