API Reference

trace_filter - Trace API

Returns traces matching the given filter.

Parameters

  • Object - The filter object
    • fromBlock: Quantity or Tag - (optional) From this block.
    • toBlock: Quantity or Tag - (optional) To this block.
    • fromAddress: Array - (optional) Sent from these addresses.
    • toAddress: Address - (optional) Sent to these addresses.
    • after: Quantity - (optional) The offset trace number.
    • count: Quantity - (optional) Integer number of traces to display in a batch.

Returns

  • Array - Traces matching given filter.

Example

Request

curl --location --request POST 'https://eth-mainnet.unifra.io/v1/{your-api-key} \
--header 'Content-Type: application/json' \
--data-raw '{"method":"trace_filter","params":[{"fromBlock":"0x1578","toBlock":"0x1580"}],"id":1,"jsonrpc":"2.0"}'

Result

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": [
        {
            "action": {
                "author": "0x228ed249a4299b231f83a502c12d904e48c5842c",
                "rewardType": "block",
                "value": "0x4563918244f40000"
            },
            "blockHash": "0x45d91eac3b898dd545def089525b9b08d1fd7ea3ab9ab63cb2c03b27224bc9f5",
            "blockNumber": 5496,
            "result": null,
            "subtraces": 0,
            "traceAddress": [],
            "type": "reward"
        },
        {
            "action": {
                "author": "0x28921e4e2c9d84f4c0f0c0ceb991f45751a0fe93",
                "rewardType": "block",
                "value": "0x4563918244f40000"
            },
            "blockHash": "0x8bdfaff2de2dfe0e8da02046a1f265c1c4c42487ebcce32ac8001ed1e8cc7e40",
            "blockNumber": 5497,
            "result": null,
            "subtraces": 0,
            "traceAddress": [],
            "type": "reward"
        },
        {
            "action": {
                "author": "0xb5edd17d2582a94610ebf0c6832c1652ebbbe210",
                "rewardType": "block",
                "value": "0x478eae0e571ba000"
            },
            "blockHash": "0xf1794c9f9cdec4204259658a9a02b15a77291a49ad73d864b3b27ebc2fcc863a",
            "blockNumber": 5498,
            "result": null,
            "subtraces": 0,
            "traceAddress": [],
            "type": "reward"
        },
        {
            "action": {
                "author": "0x228ed249a4299b231f83a502c12d904e48c5842c",
                "rewardType": "uncle",
                "value": "0x340aad21b3b70000"
            },
            "blockHash": "0xf1794c9f9cdec4204259658a9a02b15a77291a49ad73d864b3b27ebc2fcc863a",
            "blockNumber": 5498,
            "result": null,
            "subtraces": 0,
            "traceAddress": [],
            "type": "reward"
        },
        {
            "action": {
                "author": "0xf96ffed8e5116236f560026ae3658ee0f4ebd622",
                "rewardType": "block",
                "value": "0x4563918244f40000"
            },
            "blockHash": "0x03f25a18db0a484fef6f376acee94c72881af4ccdb84c02cacb32bff334b5f48",
            "blockNumber": 5499,
            "result": null,
            "subtraces": 0,
            "traceAddress": [],
            "type": "reward"
        },
        {
            "action": {
                "author": "0xad5c1768e5974c231b2148169da064e61910f31a",
                "rewardType": "block",
                "value": "0x4563918244f40000"
            },
            "blockHash": "0xf8647c4618de84ee8b73f2947abf7af43d9cae0d650ff8fcd146d8f78bf810c7",
            "blockNumber": 5500,
            "result": null,
            "subtraces": 0,
            "traceAddress": [],
            "type": "reward"
        },
        {
            "action": {
                "author": "0xf927a40c8b7f6e07c5af7fa2155b4864a4112b13",
                "rewardType": "block",
                "value": "0x4563918244f40000"
            },
            "blockHash": "0x6c81a4ad8dd2af60052dea5f77be34b8329c9ad37706593a1db40e120cd253b1",
            "blockNumber": 5501,
            "result": null,
            "subtraces": 0,
            "traceAddress": [],
            "type": "reward"
        },
        {
            "action": {
                "author": "0x228ed249a4299b231f83a502c12d904e48c5842c",
                "rewardType": "block",
                "value": "0x4563918244f40000"
            },
            "blockHash": "0x402dc3d7056d92287738172245aec472c45341cc4a6e0945fb4cf0111afa18c0",
            "blockNumber": 5502,
            "result": null,
            "subtraces": 0,
            "traceAddress": [],
            "type": "reward"
        },
        {
            "action": {
                "author": "0x789437c6ef5174651c9a9ba426a79194a84a5042",
                "rewardType": "block",
                "value": "0x4563918244f40000"
            },
            "blockHash": "0x2e09ef6b151a8df427e8f3dfcf6c5e2dbbb0c21ef8b08ede484a7d25dcc300d6",
            "blockNumber": 5503,
            "result": null,
            "subtraces": 0,
            "traceAddress": [],
            "type": "reward"
        },
        {
            "action": {
                "author": "0xb5edd17d2582a94610ebf0c6832c1652ebbbe210",
                "rewardType": "block",
                "value": "0x4563918244f40000"
            },
            "blockHash": "0x326728eb5f62b0da1ee8ad1ce9aeef008efbbe32ebcba58d8447f100621e94f1",
            "blockNumber": 5504,
            "result": null,
            "subtraces": 0,
            "traceAddress": [],
            "type": "reward"
        }
    ]
}
Language
Click Try It! to start a request and see the response here!