🧬Event logs
Summary
This endpoint returns event logs for the given event address, up to 1000 at a time. If there are more, it also returns a resume_token which can be used to fetch the next batch of logs.
Syntax
GET /$CHAIN/v1/event/$ADDRESS/logs
Query params
Param | Default value | Note |
---|---|---|
num | 1000 |
|
rt | empty |
|
t0 | empty |
|
t1 | empty |
|
t1_type | empty |
|
t2 | empty |
|
t2_type | empty |
|
Examples
USDC transfer events to vitalik.eth on Ethereum, 10 at a time
USDC contract = 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
vitalik.eth = 0xd8da6bf26964af9d7eed9e03e53415d37aa96045
topic0 hash for ERC20 transfers = 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
Request
curl -H "API-Key:$API_KEY" 'https://api.nexandria.com/eth/v1/event/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/logs?t0=0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef&t2addr=0xd8da6bf26964af9d7eed9e03e53415d37aa96045&t2_type=decoded_address&num=10' | json_pp
Response
{
"logs" : [
{
"address" : "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"block" : {
"number" : 19724899,
"unix_timestamp" : 1713957599
},
"data" : "00000000000000000000000000000000000000000000000000000000001e8480",
"parent_transaction_hash" : "0x3c52e3779b2d8d6266c94e524769342966e86f9c2a943dbf503af0d7304e1611",
"signature" : "Transfer(address,address,uint256)",
"topic0" : "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"topic1" : "0x00000000000000000000000081ad046ae9a7ad56092fa7a7f09a04c82064e16c",
"topic2" : "0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045"
},
{
"address" : "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"block" : {
"number" : 19606221,
"unix_timestamp" : 1712522051
},
"data" : "000000000000000000000000000000000000000000000000000000000137cf78",
"parent_transaction_hash" : "0x67ed6332fcc40217455e9b62b3714a395c2bf16039c6de451d99dfec1eb2896e",
"signature" : "Transfer(address,address,uint256)",
"topic0" : "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"topic1" : "0x000000000000000000000000446d6b8ae2eca3d2ceb17989ca493766badc20c7",
"topic2" : "0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045"
},
{
"address" : "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"block" : {
"number" : 19588081,
"unix_timestamp" : 1712302403
},
"data" : "0000000000000000000000000000000000000000000000000000000000989680",
"parent_transaction_hash" : "0x58fd374441dccefd80fe24580ab6e66cddb530916c57a96548c7c012aa8c9964",
"signature" : "Transfer(address,address,uint256)",
"topic0" : "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"topic1" : "0x0000000000000000000000007d8c600aa25a214ec5c641497d2a9765dd6f24c4",
"topic2" : "0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045"
},
{
"address" : "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"block" : {
"number" : 19504988,
"unix_timestamp" : 1711290443
},
"data" : "0000000000000000000000000000000000000000000000000000000005f5e100",
"parent_transaction_hash" : "0x562e4600b4dbd3df187869e6b7a512d2dd395cc469e8f0d7831269ac59163c09",
"signature" : "Transfer(address,address,uint256)",
"topic0" : "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"topic1" : "0x000000000000000000000000fee20506220eedd1f2c5526d6e88a0cf1a501b4e",
"topic2" : "0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045"
},
{
"address" : "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"block" : {
"number" : 19498668,
"unix_timestamp" : 1711213451
},
"data" : "0000000000000000000000000000000000000000000000000000000001312d00",
"parent_transaction_hash" : "0x766ccf837db96f38d30ae2e9baad39ee372d8a32d3f25984474e61ae71e11741",
"signature" : "Transfer(address,address,uint256)",
"topic0" : "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"topic1" : "0x0000000000000000000000004322571f4cac80b5b455b1393bbd4f44b999825e",
"topic2" : "0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045"
},
{
"address" : "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"block" : {
"number" : 19490847,
"unix_timestamp" : 1711118747
},
"data" : "000000000000000000000000000000000000000000000000000000000007a120",
"parent_transaction_hash" : "0xc514c3175f09b4826114e92f18443cc93236d3e8a591f6671666b496b116a8e4",
"signature" : "Transfer(address,address,uint256)",
"topic0" : "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"topic1" : "0x0000000000000000000000009319dd4ceeb4d0a85cabbb65b8bf6bf0c1da8bfa",
"topic2" : "0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045"
},
{
"address" : "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"block" : {
"number" : 19365587,
"unix_timestamp" : 1709600951
},
"data" : "000000000000000000000000000000000000000000000000000000174876e800",
"parent_transaction_hash" : "0x78af4c22f1891375fabe0538f48427cddf59f3d878d761ea249266b021ef89d1",
"signature" : "Transfer(address,address,uint256)",
"topic0" : "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"topic1" : "0x0000000000000000000000009008d19f58aabd9ed0d60971565aa8510560ab41",
"topic2" : "0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045"
},
{
"address" : "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"block" : {
"number" : 19263668,
"unix_timestamp" : 1708368647
},
"data" : "00000000000000000000000000000000000000000000000000000000001e8480",
"parent_transaction_hash" : "0x76b49b0f3d83d719e4c1777cc1060c6e13d02a05b2c0ca8169c1e20ba48a50fc",
"signature" : "Transfer(address,address,uint256)",
"topic0" : "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"topic1" : "0x000000000000000000000000904608ad77221ac0caae43cbbb16f2a886f88483",
"topic2" : "0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045"
},
{
"address" : "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"block" : {
"number" : 19209162,
"unix_timestamp" : 1707707243
},
"data" : "000000000000000000000000000000000000000000000000000000000337f980",
"parent_transaction_hash" : "0x7f45c35528ea437ae8ac339c2e004d9dc186329b1ae7cdd9334590695269ba0e",
"signature" : "Transfer(address,address,uint256)",
"topic0" : "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"topic1" : "0x000000000000000000000000b6b782bc410c976d032edf950b8ec512cb7dc2bc",
"topic2" : "0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045"
},
{
"address" : "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"block" : {
"number" : 19175245,
"unix_timestamp" : 1707295931
},
"data" : "00000000000000000000000000000000000000000000000000000000000f4240",
"parent_transaction_hash" : "0x25d54fc28676c06656f7ae5a6a097a84c1f89b0b703dc7cd31b0f15d2b2f9df9",
"signature" : "Transfer(address,address,uint256)",
"topic0" : "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"topic1" : "0x000000000000000000000000322520845d8d28f4ffd08676ecc05c33c40ac4cf",
"topic2" : "0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045"
}
],
"resume_token" : "ks0E6M4AIUru"
}
Pool creation event for Uniswap V3 factory on Ethereum where token1 was WETH, 10 at a time
Uniswap V3 factory address = 0x1f98431c8ad98523631ae4a59f267346ea31f984
WETH contract address = 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2
raw 32 byte hash for WETH contract address = 0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2
topic0 hash for pool creation events = 0x783cca1c0412dd0d695e784568c96da2e9c22ff989357a2e8b1d9b2b4e6b7118
Request
curl -H "API-Key:$API_KEY" 'https://api.nexandria.com/eth/v1/event/0x1f98431c8ad98523631ae4a59f267346ea31f984/logs?t0=0x783cca1c0412dd0d695e784568c96da2e9c22ff989357a2e8b1d9b2b4e6b7118&t1=0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2&t1_type=raw&num=10' | json_pp
Response
{
"logs" : [
{
"address" : "0x1f98431c8ad98523631ae4a59f267346ea31f984",
"block" : {
"number" : 19835317,
"unix_timestamp" : 1715291903
},
"data" : "000000000000000000000000000000000000000000000000000000000000003c0000000000000000000000006e14ce938578a5e5279594fb9a8fc09eef3b97fa",
"parent_transaction_hash" : "0x8dae57a4c621965cd50d0dab54cf59c176839c593a4e764262d2e8c702776965",
"signature" : "PoolCreated(address,address,uint24,int24,address)",
"topic0" : "0x783cca1c0412dd0d695e784568c96da2e9c22ff989357a2e8b1d9b2b4e6b7118",
"topic1" : "0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"topic2" : "0x000000000000000000000000fd4856b0334fdae60ba2972f43cc027e5e6d215e",
"topic3" : "0x0000000000000000000000000000000000000000000000000000000000000bb8"
},
{
"address" : "0x1f98431c8ad98523631ae4a59f267346ea31f984",
"block" : {
"number" : 19832298,
"unix_timestamp" : 1715255435
},
"data" : "000000000000000000000000000000000000000000000000000000000000003c000000000000000000000000d0d8e1cae914317c37a0acb8a41fc309954a9075",
"parent_transaction_hash" : "0x9cbd55d0dd2626f829d1dcd1b7b6782ce9df770928ecc4fdd8960abce8256ef9",
"signature" : "PoolCreated(address,address,uint24,int24,address)",
"topic0" : "0x783cca1c0412dd0d695e784568c96da2e9c22ff989357a2e8b1d9b2b4e6b7118",
"topic1" : "0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"topic2" : "0x000000000000000000000000d3043d66afe00344c115f7f81d18277c5c718ff8",
"topic3" : "0x0000000000000000000000000000000000000000000000000000000000000bb8"
},
{
"address" : "0x1f98431c8ad98523631ae4a59f267346ea31f984",
"block" : {
"number" : 19831689,
"unix_timestamp" : 1715248091
},
"data" : "000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000e8d7cb70db4559238fbd0f8910716dc7ed4964b8",
"parent_transaction_hash" : "0x122cf1fcefecb97826fd1adc1e9e572ca7119109faa7b18d56db7f40062aa913",
"signature" : "PoolCreated(address,address,uint24,int24,address)",
"topic0" : "0x783cca1c0412dd0d695e784568c96da2e9c22ff989357a2e8b1d9b2b4e6b7118",
"topic1" : "0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"topic2" : "0x000000000000000000000000c548e90589b166e1364de744e6d35d8748996fe8",
"topic3" : "0x00000000000000000000000000000000000000000000000000000000000001f4"
},
{
"address" : "0x1f98431c8ad98523631ae4a59f267346ea31f984",
"block" : {
"number" : 19829687,
"unix_timestamp" : 1715223851
},
"data" : "000000000000000000000000000000000000000000000000000000000000000a000000000000000000000000382af7a99c679d7bfd4ed3af9d767472fb2cb23a",
"parent_transaction_hash" : "0xf7173a1aa897a0d928829ed7e3ab92b7c134b9357f4d763f4f0c1f70d95eef33",
"signature" : "PoolCreated(address,address,uint24,int24,address)",
"topic0" : "0x783cca1c0412dd0d695e784568c96da2e9c22ff989357a2e8b1d9b2b4e6b7118",
"topic1" : "0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"topic2" : "0x000000000000000000000000cc5acdb7cdb31a7f8065e45b5070273b75a2e804",
"topic3" : "0x00000000000000000000000000000000000000000000000000000000000001f4"
},
{
"address" : "0x1f98431c8ad98523631ae4a59f267346ea31f984",
"block" : {
"number" : 19819813,
"unix_timestamp" : 1715104523
},
"data" : "000000000000000000000000000000000000000000000000000000000000003c0000000000000000000000004e8bdc1e951e7306b9b4342e57b7bea7ffe76b99",
"parent_transaction_hash" : "0x5846179d3479eaeab42d1a2a72b407fb9ba869a819af485769230a6a54714da1",
"signature" : "PoolCreated(address,address,uint24,int24,address)",
"topic0" : "0x783cca1c0412dd0d695e784568c96da2e9c22ff989357a2e8b1d9b2b4e6b7118",
"topic1" : "0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"topic2" : "0x000000000000000000000000fea156a736dee69da8740185f7d38e14f2d99ae7",
"topic3" : "0x0000000000000000000000000000000000000000000000000000000000000bb8"
},
{
"address" : "0x1f98431c8ad98523631ae4a59f267346ea31f984",
"block" : {
"number" : 19819611,
"unix_timestamp" : 1715102087
},
"data" : "00000000000000000000000000000000000000000000000000000000000000c8000000000000000000000000872902aa9f1d3c14295e26e96b9126770adff2ab",
"parent_transaction_hash" : "0x57f3d76a8fb5b4f11ad70653f58552ed470f9f714d4602a163cb45b0e08ae75d",
"signature" : "PoolCreated(address,address,uint24,int24,address)",
"topic0" : "0x783cca1c0412dd0d695e784568c96da2e9c22ff989357a2e8b1d9b2b4e6b7118",
"topic1" : "0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"topic2" : "0x000000000000000000000000e3d11e3a4fabeca933b516681bafa08ccc6db601",
"topic3" : "0x0000000000000000000000000000000000000000000000000000000000002710"
},
{
"address" : "0x1f98431c8ad98523631ae4a59f267346ea31f984",
"block" : {
"number" : 19819064,
"unix_timestamp" : 1715095463
},
"data" : "00000000000000000000000000000000000000000000000000000000000000c8000000000000000000000000272033aa2ed9345682cde9c2480ffe8882a56764",
"parent_transaction_hash" : "0xd502791ee895e6015138acb6c1c286e01ab2837c3f0582cef0f6b8583ed10734",
"signature" : "PoolCreated(address,address,uint24,int24,address)",
"topic0" : "0x783cca1c0412dd0d695e784568c96da2e9c22ff989357a2e8b1d9b2b4e6b7118",
"topic1" : "0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"topic2" : "0x000000000000000000000000c504ebbf3448d813508a4045fb516c93c01ac845",
"topic3" : "0x0000000000000000000000000000000000000000000000000000000000002710"
},
{
"address" : "0x1f98431c8ad98523631ae4a59f267346ea31f984",
"block" : {
"number" : 19816258,
"unix_timestamp" : 1715061575
},
"data" : "0000000000000000000000000000000000000000000000000000000000000001000000000000000000000000027abebcb14aa00469a4ab5e8d3d03349f981d4f",
"parent_transaction_hash" : "0xc31d05db38553767267e7563d482e4951e792684d6ab08bff50fe41970a01a0c",
"signature" : "PoolCreated(address,address,uint24,int24,address)",
"topic0" : "0x783cca1c0412dd0d695e784568c96da2e9c22ff989357a2e8b1d9b2b4e6b7118",
"topic1" : "0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"topic2" : "0x000000000000000000000000ea1a6307d9b18f8d1cbf1c3dd6aad8416c06a221",
"topic3" : "0x0000000000000000000000000000000000000000000000000000000000000064"
},
{
"address" : "0x1f98431c8ad98523631ae4a59f267346ea31f984",
"block" : {
"number" : 19811228,
"unix_timestamp" : 1715000747
},
"data" : "00000000000000000000000000000000000000000000000000000000000000c8000000000000000000000000b696496f5c7e91e36703420fb69cce227e0ad2d0",
"parent_transaction_hash" : "0x9ffafeae5cab5eb3b5c88517ec40b364372d5d2313c94cc317b36f1364030b1b",
"signature" : "PoolCreated(address,address,uint24,int24,address)",
"topic0" : "0x783cca1c0412dd0d695e784568c96da2e9c22ff989357a2e8b1d9b2b4e6b7118",
"topic1" : "0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"topic2" : "0x000000000000000000000000e9ce934c9fe9d6c3ccd1cd1948f9723296869559",
"topic3" : "0x0000000000000000000000000000000000000000000000000000000000002710"
},
{
"address" : "0x1f98431c8ad98523631ae4a59f267346ea31f984",
"block" : {
"number" : 19802924,
"unix_timestamp" : 1714900415
},
"data" : "00000000000000000000000000000000000000000000000000000000000000c8000000000000000000000000e6d71bbaf7e25504bc5921fdcd8a977936305990",
"parent_transaction_hash" : "0xcb230b59ae77c8eb824034f5a87a0b1f4fc8f19f655765fbeb802a449da12c8e",
"signature" : "PoolCreated(address,address,uint24,int24,address)",
"topic0" : "0x783cca1c0412dd0d695e784568c96da2e9c22ff989357a2e8b1d9b2b4e6b7118",
"topic1" : "0x000000000000000000000000c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"topic2" : "0x000000000000000000000000db239db28a50010bd5e8c7ac8d6953ca0bfc1c97",
"topic3" : "0x0000000000000000000000000000000000000000000000000000000000002710"
}
],
"resume_token" : "ks0FPs4ABUdR"
}
Last updated