Skip to main content

Data Sources

Updated on
Feb 26, 2024

With Streams, users can access a variety of datasets tailored for different types of blockchain data. Datasets are supported across chains and to multiple destinations.

Stream Metadata Properties

Each stream includes metadata related to your Stream's configuration. This metadata can be returned in your response's Header or Body payloads. This metadata is sent once per batch and can be optionally disabled with the option None.

Stream Metadata Properties (once per batch)
PropertyTypeDescriptionExample
batch_end_rangeintegerEnding range of batches in a dataset19271294
batch_start_rangeintegerStarting range of batches in a dataset19271294
datasetstringType of dataset"block"
end_rangeintegerEnding range of data capture200
keep_distance_from_tipintegerDistance from the tip0
networkstringRelevant blockchain network"ethereum-mainnet"
start_rangeintegerStarting range of data capture100
stream_idstringID of the stream"f6ad6459-b5ad-4183-b370-1c1388e47e83"
stream_namestringName associated with the metadata"stream test1"
stream_regionstringRegion of the stream"usa_east"

EVM Dataset Schema

Each dataset comes with a predefined schema. Below are the datasets available:

Block

The Block schema models the structure of individual blocks on a chain, including fields like hash, number, nonce, and other relevant block data. Additionally, it supports configuration options for re-org handling and batch sizes, allowing for customized data management and retrieval. This dataset is associated with the eth_getBlockByNumber JSON-RPC method.

JSON Spec

{
"data": [
{
"baseFeePerGas": "0x6e7c31607",
"difficulty": "0x0",
"extraData": "0x6265617665726275696c642e6f7267",
"gasLimit": "0x1ca35ef",
"gasUsed": "0xd0d11a",
"hash": "0xd964c5deacbea3e3df775ad1ed49744882d95dbdd1ae058b813cece959676820",
"logsBloom": "0x292120068188635813481040c8e6eb0219c8a0802f030536060d0838441189124c565900840510c8a2007c0e20928f8a3a0999019b793b0f2b07200622a9af045006265b6a008889ad03e0c9f02560a4a1d04c89546818a410803404c42bf9a45059c83b52044cb5c149534d90508d1d0c14182110cc964210089a932adc0610230a9a56020050e120d131100012159e1520a5659bdc152a4c669a42e215182a73cf0856590921122d5043e0e85d14401459a18079111a3041a40420801b00417407010a0410329528a003762013921102a410220080941082423203aa60a05c2070a4308a1408465a8690c1460d9e1a0e1c386464004064409f009308285605",
"miner": "0x95222290dd7278aa3ddd389cc1e1d165cc4bafe5",
"mixHash": "0x19e7ac2cee56deccb018d0672c957498888775f3dad93a2b036b8b90745749ca",
"nonce": "0x0000000000000000",
"number": "0x125d3e5",
"parentHash": "0xf31bcd75d2bebfe97a9aabae5c644c8d137552d2be3d8ff9f01278624d911011",
"receiptsRoot": "0xa2e62e17610b8e788552e42b19f13f70607dbf5b9b6eae8a7b70866a02d4c50d",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"size": "0x2feee",
"stateRoot": "0x7ed2f27dabd8a4c778a3d6b1578707c4bf424d58d25bed1f900464dc94c99748",
"timestamp": "0x65d2444f",
"totalDifficulty": "0xc70d815d562d3cfa955",
"transactions": [
{
"blockHash": "0xd964c5deacbea3e3df775ad1ed49744882d95dbdd1ae058b813cece959676820",
"blockNumber": "0x125d3e5",
"from": "0x9b2dfb8862e3f398b73206c879a1f38136f22908",
"gas": "0x493e7",
"gasPrice": "0xe732d3c53",
"maxFeePerGas": "0x105078f2e9",
"maxPriorityFeePerGas": "0x78b6a264c",
"hash": "0x07f77f064a73c6b9bc75e10237ff227cf97c92fbd0474418774cd1877f2c062d",
"input": "0xce2e62ff00000000000000000000000000000000000000000000025bad3c1535425133f9000000000000000000000000000000000000000000000000000000004457d792000000000000000000000000a5f0cf205af1f5b02c00ba7ab834824c01855b5400000000000000000000000080d55c03180349fff4a229102f62328220a9644400000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000065d24498",
"nonce": "0x1b58c",
"to": "0x70e86223507724bf2c51fe3ac2cc78c67bfad366",
"transactionIndex": "0x0",
"value": "0x0",
"type": "0x2",
"accessList": [
{
"address": "0x70e86223507724bf2c51fe3ac2cc78c67bfad366",
"storageKeys": [
"0x68b4f4b2b98689403b96cf28c81529d80fd5a497dff993b559d57c11f1ec2316",
"0xa881ca0109cb9fde5976e1041db2d94acc36604e6278c134e300c6824c505f54"
]
},
{
"address": "0x2a0330c7e979a4d18e5b0c987b877da24dd37d04",
"storageKeys": [
"0x0000000000000000000000000000000000000000000000000000000000000000"
]
}
],
"chainId": "0x1",
"v": "0x0",
"r": "0xd901ac6a9b791a1c7d5205d096a9a4bfee381e84bde852e7ecf84a94bfb4e047",
"s": "0x50975c4faeed4717b3b84c1ee1119b9e59809da6a7b83188d442242d970de3ff",
"yParity": "0x0"
}
],
"transactionsRoot": "0x46624a1304cc82a4f8ee010206bbf90c03dec35383f3da60f0bbe5bb7a7381d8",
"uncles": [],
"withdrawals": [
{
"index": "0x21e5146",
"validatorIndex": "0x525dd",
"address": "0xb9d7934878b5fb9610b3fe8a5e441e8fad7e293f",
"amount": "0x112df11"
}
],
"withdrawalsRoot": "0x14a3d814a58052dfa4d031cac60aead5bf124368558e88881033692c5683a677"
}
],
"metadata": {
"batch_end_range": 19271294,
"batch_start_range": 19271294,
"dataset": "block",
"end_range": -1,
"keep_distance_from_tip": 0,
"network": "ethereum-mainnet",
"start_range": 19271294,
"stream_id": "f6ad6459-b5ad-4183-b370-1c1388e47e83",
"stream_name": "ancient-cool-peak",
"stream_region": "usa_east"
}
}
Block Data Properties
PropertyTypeDescriptionExample
numberstringThe number of the block"0x84"
baseFeePerGasstringThe base fee per gas generated with every block header"0x6e7c31607"
stateRootstringState root of the block"0x4d1ee51733b6fc95a584620f8570a2396e56b74a60f525c2ce3d84a300f88c7c"
minerstringMiner of the block"0xbb7b8287f3f0a933474a79eae42cbca977791171"
unclesarrayArray of uncle block hashes["0x6a5a801b12b94e1fb24e531b087719d699882a4f948564ba58706934bc5a19ff"]
totalDifficultystringTotal difficulty till this block"0x221ec989e47"
noncestringNonce associated with the block"0x1848f1c63da1c8d2"
logsBloomstringLogs bloom filter(a string of zeros for simplicity in this example)
difficultystringDifficulty level of the block"0x43cb73bfe"
sha3UnclesstringSHA3 of the uncles data in the block"0x615211d558a695f91d2d5101db3359f08ea8bb09f16ff4e15ec51dfc8fa1b6ca"
hashstringBlock's hash"0x1567c9c59d144c48d9a981fc70f72ba84ebf557622c1f82551849c77bd637bb7"
parentHashstringHash of the parent block"0x12ef0c55f6a6adcd43b65fdf0c356927b82ef30fb8a72eddad012b726e2824b6"
gasLimitstringGas limit for the block"0x1388"
extraDatastringExtra data associated with the block"0x476574682f4c5649562f76312e302e302f6c696e75782f676f312e342e32"
sizestringSize of the block"0x43d"
timestampstringTimestamp of the block"0x55ba442e"
receiptsRootstringRoot of the receipts"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
transactionsRootstringRoot hash of the transactions"0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
gasUsedstringTotal gas used by the block"0x0"
mixHashstringMix hash of the block"0x5dfd774d3f0bb0ab5f77740d02cbb2c86a1d753b9a640cdf2df36a5994118b3c"
withdrawalsarrayAn array of withdrawal objects along with their amounts and withdrawl addresses{}
transactionsarrayArray of transactions within the block[]
withdrawalsRootstringA hash representing the withdrawals in the execution payload"0xb18439354be772e4a79c37a6e1e31e20239dc7279236d023ebeefa554bc54f40"

Block with Receipts

The Block with Receipts schema represents comprehensive details on individual blocks and their transaction receipts. These receipts contain details such as the transaction status (successful or failed), gas utilized, value transferred, logs generated, and more. This dataset is associated with both the eth_getBlockByNumber and eth_getBlockReceipts JSON-RPC methods.

JSON Spec
{
"data": [
{
"block": {
"baseFeePerGas": "0x86670bedf",
"difficulty": "0x0",
"extraData": "0x546974616e2028746974616e6275696c6465722e78797a29",
"gasLimit": "0x1c9c380",
"gasUsed": "0xcad0a7",
"hash": "0x7d1244b8fb174c7ef534b29ec8458071e40d5ecd6b6ce90aba0422499fca9817",
"logsBloom": "0x48a10b37e8a245cd74987a2ba2940671252d0a1145682058ad0518108584bd8a16aca5380020f682539a3728d20401950629894389857f8284cd1144e8fd40fa809a30795904216de82afc3fb0009fbce71a0a0920439a046c66944aca60454e9bba0889c24307026c9cd4f278765e612c386de92190170782636ff61cc9d3108f48a7d450068c0081cd00428343a17404044cc9ad51e09a603d21512bb134808ac6c1422829b091036051e1ff9240880fc6e28ae0e4973799f2e80e80bbea6618220b2e411006784070c4280b5e74b2a14c021a9f0744744b024d468120a40218f1acaa01442032cab166b13d281a10c24212da29ce0ac1125c0030314494c8",
"miner": "0x4838b106fce9647bdf1e7877bf73ce8b0bad5f97",
"mixHash": "0x52a5eeaca74e1966325ed00af0f26b2fcab5084272c48978bd3d060a63aaa48c",
"nonce": "0x0000000000000000",
"number": "0x12661c1",
"parentHash": "0x25dcc1b6cebe93fad161f5eded5c516d0cd5bdf31a323671b7d7774c83c55291",
"receiptsRoot": "0xe8d2371bf7ea3a5b5f4ccf819390b286cd297331854edee136ce37b72e2dafa5",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"size": "0x35bf1",
"stateRoot": "0xdf0beab52215800e252f8246a936502651ef6dab3ec44683e4b5c75c2f8c80a3",
"timestamp": "0x65d8fcdb",
"totalDifficulty": "0xc70d815d562d3cfa955",
"transactions": [
{
"blockHash": "0x7d1244b8fb174c7ef534b29ec8458071e40d5ecd6b6ce90aba0422499fca9817",
"blockNumber": "0x12661c1",
"from": "0x52b86a86e4d764e8275391c436127e60340a0e6a",
"gas": "0x58d26",
"gasPrice": "0x86670bedf",
"maxFeePerGas": "0x9733ed6ba",
"maxPriorityFeePerGas": "0x0",
"hash": "0xaef9c63106872237ef7b9efa5a622c3eaa54ea57cab01ab20597567a656ac83e",
"input": "0x5c19a95c0000000000000000000000005bcff630e4ff5546973365229ee6df89b29573903ca0b571af8e24597e45719fcd2500000000000000000000000000000000000000000000000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc200000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006db49ec45bf13800000000000000000000000000000000000000000000000000000000055f30b50dd000000000000000000000000d51a44d3fae010294c616388b506acda1bfaae460000000000000000000000000000000000000000000000000000000000000000",
"nonce": "0x71dd",
"to": "0x00000000003b3cc22af3ae1eac0440bcee416b40",
"transactionIndex": "0x0",
"value": "0x0",
"type": "0x2",
"accessList": [
{
"address": "0x5bcff630e4ff5546973365229ee6df89b2957390",
"storageKeys": []
},
{
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"storageKeys": [
"0xb070b34862666c8affb1f4329f447baa5d24469ba3deaf4a8804035673d891d3",
"0x3c679e5fc421e825187f885e3dcd7f4493f886ceeb4930450588e35818a32b9c",
"0x9b354f30d74ca151470e4c01c97d425c838beac0ab30a0bd396660e4405f8bee"
]
},
{
"address": "0xd51a44d3fae010294c616388b506acda1bfaae46",
"storageKeys": [
"0x0000000000000000000000000000000000000000000000000000000000000007",
"0x000000000000000000000000000000000000000000000000000000000000000a",
"0x0000000000000000000000000000000000000000000000000000000000000003",
"0x000000000000000000000000000000000000000000000000000000000000000c",
"0x000000000000000000000000000000000000000000000000000000000000001e",
"0x0000000000000000000000000000000000000000000000000000000000000005",
"0xd833147d7dc355ba459fc788f669e58cfaf9dc25ddcd0702e87d69c7b5124289",
"0x0000000000000000000000000000000000000000000000000000000000000017",
"0x0000000000000000000000000000000000000000000000000000000000000010",
"0x0000000000000000000000000000000000000000000000000000000000000001",
"0xd833147d7dc355ba459fc788f669e58cfaf9dc25ddcd0702e87d69c7b512428b",
"0x0000000000000000000000000000000000000000000000000000000000000011",
"0x000000000000000000000000000000000000000000000000000000000000000e",
"0x000000000000000000000000000000000000000000000000000000000000001c",
"0x000000000000000000000000000000000000000000000000000000000000001d",
"0x0000000000000000000000000000000000000000000000000000000000000023",
"0xd833147d7dc355ba459fc788f669e58cfaf9dc25ddcd0702e87d69c7b512428a",
"0x0000000000000000000000000000000000000000000000000000000000000000",
"0x0000000000000000000000000000000000000000000000000000000000000002",
"0x000000000000000000000000000000000000000000000000000000000000001a"
]
},
{
"address": "0x8f68f4810cce3194b6cb6f3d50fa58c2c9bdd1d5",
"storageKeys": []
},
{
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"storageKeys": [
"0x0000000000000000000000000000000000000000000000000000000000000004",
"0xeb449bc003e7395128833de1fb3384246962a9d4d29c66083486accd9139c704",
"0x4e4964f8ffa515e8b3b3cb6c8bb68664c7975f07a219a1ec91eff1760c1921eb",
"0x0000000000000000000000000000000000000000000000000000000000000000",
"0x32386aa1ea2888e40243b524a67e7408609a4257cebaa46f72ca08964fad63c9",
"0x000000000000000000000000000000000000000000000000000000000000000a",
"0x0000000000000000000000000000000000000000000000000000000000000003"
]
},
{
"address": "0xc4ad29ba4b3c580e6d59105fff484999997675ff",
"storageKeys": [
"0x0000000000000000000000000000000000000000000000000000000000000004"
]
}
],
"chainId": "0x1",
"v": "0x1",
"r": "0x4b1daf44f967104d455288f5681471441d2c8ca162af2dab2eac9997cc41026c",
"s": "0x138601b661efe9ba5e7c2e46584c74e35bc36b284aa66fd45cc4f99cad3a4b5",
"yParity": "0x1"
}
],
"transactionsRoot": "0x5d95d00c8fb2dc2f727018013cc57059c1f91c99d9eb642326bd3f94640f09fd",
"uncles": [],
"withdrawals": [
{
"index": "0x2272f06",
"validatorIndex": "0xfe7c4",
"address": "0xcde4c1b984f3f02f997ecff9980b06316de2577d",
"amount": "0x10f358b"
},
{
"index": "0x2272f07",
"validatorIndex": "0xfe7c5",
"address": "0xcde4c1b984f3f02f997ecff9980b06316de2577d",
"amount": "0x11157bb"
},
{
"index": "0x2272f08",
"validatorIndex": "0xfe7c6",
"address": "0xcde4c1b984f3f02f997ecff9980b06316de2577d",
"amount": "0x1108f07"
},
{
"index": "0x2272f09",
"validatorIndex": "0xfe7c7",
"address": "0xcde4c1b984f3f02f997ecff9980b06316de2577d",
"amount": "0x1102e96"
},
{
"index": "0x2272f0a",
"validatorIndex": "0xfe7c8",
"address": "0xcde4c1b984f3f02f997ecff9980b06316de2577d",
"amount": "0x10e769f"
},
{
"index": "0x2272f0b",
"validatorIndex": "0xfe7c9",
"address": "0xcde4c1b984f3f02f997ecff9980b06316de2577d",
"amount": "0x10f32d7"
},
{
"index": "0x2272f0c",
"validatorIndex": "0xfe7ca",
"address": "0xcde4c1b984f3f02f997ecff9980b06316de2577d",
"amount": "0x3a7c975"
},
{
"index": "0x2272f0d",
"validatorIndex": "0xfe7cb",
"address": "0xcde4c1b984f3f02f997ecff9980b06316de2577d",
"amount": "0x10fbf31"
},
{
"index": "0x2272f0e",
"validatorIndex": "0xfe7cc",
"address": "0xcde4c1b984f3f02f997ecff9980b06316de2577d",
"amount": "0x10ef2b8"
},
{
"index": "0x2272f0f",
"validatorIndex": "0xfe7cd",
"address": "0xcde4c1b984f3f02f997ecff9980b06316de2577d",
"amount": "0x10f9ba3"
},
{
"index": "0x2272f10",
"validatorIndex": "0xfe7ce",
"address": "0xcde4c1b984f3f02f997ecff9980b06316de2577d",
"amount": "0x1102f87"
},
{
"index": "0x2272f11",
"validatorIndex": "0xfe7cf",
"address": "0xcde4c1b984f3f02f997ecff9980b06316de2577d",
"amount": "0x110e9a6"
},
{
"index": "0x2272f12",
"validatorIndex": "0xfe7d0",
"address": "0xcde4c1b984f3f02f997ecff9980b06316de2577d",
"amount": "0x10fcf5b"
},
{
"index": "0x2272f13",
"validatorIndex": "0xfe7d1",
"address": "0xcde4c1b984f3f02f997ecff9980b06316de2577d",
"amount": "0x110698f"
},
{
"index": "0x2272f14",
"validatorIndex": "0xfe7d2",
"address": "0xcde4c1b984f3f02f997ecff9980b06316de2577d",
"amount": "0x11071b8"
},
{
"index": "0x2272f15",
"validatorIndex": "0xfe7d3",
"address": "0xcde4c1b984f3f02f997ecff9980b06316de2577d",
"amount": "0x10fce54"
}
],
"withdrawalsRoot": "0x1fd01cbc327ca30335ef960dc0dd42363f6c839f577ff4567ad2400cf6c77656"
},
"receipts": [
{
"blockHash": "0x7d1244b8fb174c7ef534b29ec8458071e40d5ecd6b6ce90aba0422499fca9817",
"blockNumber": "0x12661c1",
"contractAddress": null,
"cumulativeGasUsed": "0x464d8",
"effectiveGasPrice": "0x86670bedf",
"from": "0x52b86a86e4d764e8275391c436127e60340a0e6a",
"gasUsed": "0x464d8",
"logs": [
{
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"topics": [
"0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925",
"0x00000000000000000000000000000000003b3cc22af3ae1eac0440bcee416b40",
"0x000000000000000000000000d51a44d3fae010294c616388b506acda1bfaae46"
],
"data": "0x000000000000000000000000000000000000000000000006db49ec45bf138000",
"blockNumber": "0x12661c1",
"transactionHash": "0xaef9c63106872237ef7b9efa5a622c3eaa54ea57cab01ab20597567a656ac83e",
"transactionIndex": "0x0",
"blockHash": "0x7d1244b8fb174c7ef534b29ec8458071e40d5ecd6b6ce90aba0422499fca9817",
"logIndex": "0x0",
"removed": false
},
{
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"topics": [
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x00000000000000000000000000000000003b3cc22af3ae1eac0440bcee416b40",
"0x000000000000000000000000d51a44d3fae010294c616388b506acda1bfaae46"
],
"data": "0x000000000000000000000000000000000000000000000006db49ec45bf138000",
"blockNumber": "0x12661c1",
"transactionHash": "0xaef9c63106872237ef7b9efa5a622c3eaa54ea57cab01ab20597567a656ac83e",
"transactionIndex": "0x0",
"blockHash": "0x7d1244b8fb174c7ef534b29ec8458071e40d5ecd6b6ce90aba0422499fca9817",
"logIndex": "0x1",
"removed": false
},
{
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"topics": [
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x000000000000000000000000d51a44d3fae010294c616388b506acda1bfaae46",
"0x00000000000000000000000000000000003b3cc22af3ae1eac0440bcee416b40"
],
"data": "0x00000000000000000000000000000000000000000000000000000055f30b50dd",
"blockNumber": "0x12661c1",
"transactionHash": "0xaef9c63106872237ef7b9efa5a622c3eaa54ea57cab01ab20597567a656ac83e",
"transactionIndex": "0x0",
"blockHash": "0x7d1244b8fb174c7ef534b29ec8458071e40d5ecd6b6ce90aba0422499fca9817",
"logIndex": "0x2",
"removed": false
},
{
"address": "0xd51a44d3fae010294c616388b506acda1bfaae46",
"topics": [
"0xb2e76ae99761dc136e598d4a629bb347eccb9532a5f8bbd72e18467c3c34cc98",
"0x00000000000000000000000000000000003b3cc22af3ae1eac0440bcee416b40"
],
"data": "0x0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000006db49ec45bf138000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000055f30b50dd",
"blockNumber": "0x12661c1",
"transactionHash": "0xaef9c63106872237ef7b9efa5a622c3eaa54ea57cab01ab20597567a656ac83e",
"transactionIndex": "0x0",
"blockHash": "0x7d1244b8fb174c7ef534b29ec8458071e40d5ecd6b6ce90aba0422499fca9817",
"logIndex": "0x3",
"removed": false
}
],
"logsBloom": "0x00000000000000800000000000000000000000000000000020000000000000000000000000000000000000000000010002000100080000000040000000200000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000100000020000000000000000000080000000000080000000000000000000000000000000000006000000000040000000000000000000000000001000000000000000000010200001000000000100000020000000000000000000000000000000000000",
"status": "0x1",
"to": "0x00000000003b3cc22af3ae1eac0440bcee416b40",
"transactionHash": "0xaef9c63106872237ef7b9efa5a622c3eaa54ea57cab01ab20597567a656ac83e",
"transactionIndex": "0x0",
"type": "0x2"
}
]
}
],
"metadata": {
"batch_end_range": 19293282,
"batch_start_range": 19293282,
"dataset": "block_with_receipts",
"end_range": -1,
"keep_distance_from_tip": 0,
"network": "ethereum-mainnet",
"start_range": 19293282,
"stream_id": "f23eeacb-05b6-4159-a90d-5903dfe229dc",
"stream_name": "slow-brave-savanna",
"stream_region": "usa_east"
}
}
Block with Receipts Properties
PropertyTypeDescription
transactionHashstringThe hash of the transaction.
tostringThe address of the recipient. In case the transaction resulted in contract creation, this field will be null.
effectiveGasPricestringThe gas price effectively paid after accounting for baseFeePerGas and maxPriorityFeePerGas. (EIP-1559 transactions)
blockHashstringHash of the block where this transaction was in.
gasUsedstringThe amount of gas used by this specific transaction alone.
cumulativeGasUsedstringThe total amount of gas used when this transaction was executed in the block.
fromstringThe address of the sender.
contractAddressnullAddress of the contract created if the transaction was a contract creation; otherwise, null.
logsBloomstringThe Bloom filter for the logs of the transaction.
statusstringStatus of the transaction. 0x1 indicates success, and 0x0 indicates failure.
blockNumberstringNumber of the block where this transaction was in.
transactionIndexstringInteger of the transaction's position in the block.
typestringIndicates the type of the transaction. For EIP-1559 transactions, it would be 0x2.
logsarrayArray of log objects, which this transaction generated.

Receipts

The Receipts schema corresponds to transaction receipts, focusing soley on transactions and excluding block details. These receipts serve as proof of transaction execution, detailing outcomes, and specifics like gas usage, corresponding to the eth_getBlockReceipts JSON-RPC method.

JSON Spec
{
"data": [
[
{
"blockHash": "0xfed2c9676e3a2ca4bb3f945502007a8f4edd73f903e878c62b77c8e79291fe8e",
"blockNumber": "0x12609a9",
"contractAddress": null,
"cumulativeGasUsed": "0x1f228",
"effectiveGasPrice": "0x8db7a1b7d",
"from": "0xf8ac19dca1d53c337b0a029e045919c416db42e4",
"gasUsed": "0x1f228",
"logs": [
{
"address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"topics": [
"0xe1fffcc4923d04b559f4d29a8bfc6cda04eb5b0d3c460751c2402c5c5cc9109c",
"0x0000000000000000000000003fc91a3afd70395cd496c647d5a6cc9d4b2b7fad"
],
"data": "0x00000000000000000000000000000000000000000000000002c68af0bb140000",
"blockNumber": "0x12609a9",
"transactionHash": "0x5a688e21a9586872dc571df359e34ed939e0ec83c9115e4e7210cc08b2078a88",
"transactionIndex": "0x0",
"blockHash": "0xfed2c9676e3a2ca4bb3f945502007a8f4edd73f903e878c62b77c8e79291fe8e",
"logIndex": "0x0",
"removed": false
}
],
"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010002000000080020000000000000000008000000080000000800000008000000000000000000000000000010008020100000000000000000000000000000000000000800000000000000000090000800000000000000000000000000000000000000000001000000000400000000100000000000000000000000000080000000000000000000000000000004000000000000000002000000001000000000000008000000000000000000000000000000000000200000000000000000000000000000001000000000400008001000004000",
"status": "0x1",
"to": "0x3fc91a3afd70395cd496c647d5a6cc9d4b2b7fad",
"transactionHash": "0x660608b859bbf9e48211c13f802e01cfd946f6ebb72e64dd0794031f198fa22f",
"transactionIndex": "0x90",
"type": "0x2"
}
]
],
"metadata": {
"batch_end_range": 19271294,
"batch_start_range": 19271294,
"dataset": "receipts",
"end_range": -1,
"keep_distance_from_tip": 0,
"network": "ethereum-mainnet",
"start_range": 19271294,
"stream_id": "7328e582-8952-492a-93b8-d43f21aeb17d",
"stream_name": "young-adventurous-spring",
"stream_region": "usa_east"
}
}
Receipts Data Schema
PropertyTypeDescription
transactionHashstringThe hash of the transaction.
tostringThe address of the recipient. In case the transaction resulted in contract creation, this field will be null.
effectiveGasPricestringThe gas price effectively paid after accounting for baseFeePerGas and maxPriorityFeePerGas. (EIP-1559 transactions)
blockHashstringHash of the block where this transaction was in.
gasUsedstringThe amount of gas used by this specific transaction alone.
cumulativeGasUsedstringThe total amount of gas used when this transaction was executed in the block.
fromstringThe address of the sender.
contractAddressnullAddress of the contract created if the transaction was a contract creation; otherwise, null.
logsBloomstringThe Bloom filter for the logs of the transaction.
statusstringStatus of the transaction. 0x1 indicates success, and 0x0 indicates failure.
blockNumberstringNumber of the block where this transaction was in.
transactionIndexstringInteger of the transaction's position in the block.
typestringIndicates the type of the transaction. For EIP-1559 transactions, it would be 0x2.
logsarrayArray of log objects, which this transaction generated.

Transactions

The Transactions data schema narrows data down to focus on transaction details, similar to each transaction object you would get when using the eth_getTransactionByHash method. It utilizes transaction hashes, returned from a method like eth_getBlockByNumber, to loop over each transaction hash and return its transaction object. This makes it easy to look up detailed transaction information.

JSON Spec
{
"data": [
[
{
"accessList": [],
"blockHash": "0x9172cbeba169f0f6d160ea44a4fa19207028e206f201e90b4f7698dcbedc0d79",
"blockNumber": "0x125d413",
"chainId": "0x1",
"from": "0x27a5997dbce4945dd5f266d3d67ede87515bf756",
"gas": "0x2a9c4",
"gasPrice": "0xfc79e4bab",
"hash": "0xbd19779d2aa51278e7c74ca9ce588d0807892dcfddb3612ea08663806995d1d5",
"input": "0xb6f9de950000000000000000000000000000000000000000036c1e835710a5a000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000027a5997dbce4945dd5f266d3d67ede87515bf7560000000000000000000000000000000000000000000000000000000065d248cb0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2000000000000000000000000b33f174b80f7f79c9ed0b2e825e922b73e6dadce",
"maxFeePerGas": "0x1c45322b00",
"maxPriorityFeePerGas": "0x826299e00",
"nonce": "0x5ce",
"r": "0x65214555d04d96e826ed6fa97ecde953c863286d5b1716c72b0d83eb67eb733c",
"s": "0x703ae0f20eb538b90ef6b8ec49d01093fc3af7f20b88c8ddf5bcd2595da15c47",
"to": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",
"transactionIndex": "0x0",
"type": "0x2",
"v": "0x1",
"value": "0xb1a2bc2ec50000",
"yParity": "0x1"
},
"{...}"
]
],
"metadata": {
"batch_end_range": 19271337,
"batch_start_range": 19271337,
"dataset": "transactions",
"end_range": -1,
"keep_distance_from_tip": 0,
"network": "ethereum-mainnet",
"start_range": 19271294,
"stream_id": "b0f5e121-7ab1-401b-a883-d857b0551997",
"stream_name": "late-long-volcano",
"stream_region": "usa_east"
}
}
Transaction Data Properties
PropertyTypeOptionalDescriptionExample
blockHashstringNoThe hash of the block containing this transaction"0x7c507ebb..."
blockNumberstringNoThe block number where this transaction was included, in hexadecimal"0x1253b07"
chainIdstringNoIdentifier of the Ethereum chain, in hexadecimal"0x1"
fromstringNoAddress of the transaction sender"0x8e3eedf2..."
gasstringNoGas limit set by the sender, in hexadecimal"0x29389"
gasPricestringYesGas price set by the sender, in hexadecimal (absent in EIP-1559 txns)"0xf27aa6dfb"
hashstringNoHash of the transaction"0x4992e62b..."
inputstringNoData sent along with the transaction"0x7ff36ab5..."
noncestringNoTransaction count of the sender, in hexadecimal"0x1658"
rstringNoPart of the ECDSA signature of the transaction"0x8337e06..."
sstringNoPart of the ECDSA signature of the transaction"0x351adf2..."
tostringNoAddress of the transaction receiver"0x7a250d56..."
transactionIndexstringNoIndex of the transaction in the block, in hexadecimal"0x0"
typestringNoType of the transaction, indicating the EIP standard it conforms to"0x0"
vstringNoRecovery byte of the signature"0x25"
valuestringNoValue transferred in the transaction, in hexadecimal"0xac2e8abea32971c"
maxFeePerGasstringYesMaximum fee per gas the sender is willing to pay, in hexadecimal (EIP-1559 transactions only)"0x791593edb"
maxPriorityFeePerGasstringYesMaximum priority fee per gas, in hexadecimal (EIP-1559 transactions only)"0x8d40c1"
accessListarrayYesList of addresses and storage keys the transaction will access (EIP-2930 and EIP-1559 transactions)[{"address": "0x69304...", "storageKeys": ["0x8c9b97..."]}]
yParitystringYesParity of the y-coordinate of the curve point for the signature (EIP-1559 transactions only)"0x1"

Logs

The Logs data schema corresponds to event logs generated by smart contract transactions. Logs document significant events, function calls, or other relevant activities occurring within a smart contract, associated with the eth_getLogs JSON-RPC method, providing insights on smart contract interactions per block.

JSON Spec
{
"data": [
[
{
"address": "0xe18a6a48a41f41d774342d5508cc327af10838b2",
"blockHash": "0x8ea58ce38c01915e30816c05d4e156b48522e90646c69325ffee532ab63ee67d",
"blockNumber": "0x1260e7e",
"data": "0x000000000000000000000000579bd1582e0a4800df4ac5f5796261ad3597a1fc0000000000000000000000000000000000000000000000188ea34be733f40000",
"logIndex": "0xd5",
"removed": false,
"topics": [
"0xd8138f8a3f377c5259ca548e70e4c2de94f129f5a11036a15b69513cba2b426a"
],
"transactionHash": "0xc301093e0d28de0eb918cfcfbbde64367da0871b1032357265c5b95525fba00d",
"transactionIndex": "0x91"
},
{
"address": "0x8457ca5040ad67fdebbcc8edce889a335bc0fbfb",
"blockHash": "0x8ea58ce38c01915e30816c05d4e156b48522e90646c69325ffee532ab63ee67d",
"blockNumber": "0x1260e7e",
"data": "0x0000000000000000000000000000000000000000000000188ea34be733f40000",
"logIndex": "0xd6",
"removed": false,
"topics": [
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x0000000000000000000000003af2acb662a241da4ef4310c7ab226f552b42115",
"0x000000000000000000000000579bd1582e0a4800df4ac5f5796261ad3597a1fc"
],
"transactionHash": "0xc301093e0d28de0eb918cfcfbbde64367da0871b1032357265c5b95525fba00d",
"transactionIndex": "0x91"
}
],
[]
],
"metadata": {
"batch_end_range": 19271294,
"batch_start_range": 19271294,
"dataset": "logs",
"end_range": -1,
"keep_distance_from_tip": 0,
"network": "ethereum-mainnet",
"start_range": 19271294,
"stream_id": "5e791676-666c-4d9f-bb17-1cc2480a21dc",
"stream_name": "heavy-modern-desert",
"stream_region": "usa_east"
}
}
Logs Data Schema
FieldTypeDescription
addressstringThe address from which this log originated (usually the contract address).
topicsarrayAn array of topics (up to four). The first topic is the hash of the event signature. Additional topics can be used for indexed event parameters.
transactionHashstringThe hash of the transaction.
datastringContains the non-indexed event parameters in ABI-encoded format.
transactionIndexstringInteger of the transaction's position in the block.
logIndexstringInteger of the log's position in the block.
blockHashstringHash of the block where this log was in.
blockNumberstringNumber of the block where this log was in.
removedbooleanIndicates if the log was removed due to a chain reorganization. True when the log was removed; false if it was added.

Want other Datasets?

If you're in search of additional datasets or have specific data needs not currently covered, we'd love to hear from you! Your feedback is invaluable in helping us expand and tailor our offerings to better serve your requirements. Please don't hesitate to reach out with your suggestions and requests: Streams Feedback

Share this doc