🧬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	if specified, value should be between 1 and 1000
rt	empty	specifies the resume_token (obtained via the previous request) from which to fetch the next batch of event logs resume_tokens are generated using an encoding safe for URLs and you should use it as is
t0	empty	restricts logs to the specified topic0 hash expected value if specified: full 32 byte hash
t1	empty	restricts logs to the specified topic1 value t1_type must be specified whenever specifying t1
t1_type	empty	must be specified when specifying t1 possible values: raw - t1 is 32 byte hash decoded_address - t1 is an EVM address decoded_uint256 - t1 is a decoded uint256
t2	empty	restricts logs to the specified topic2 value t2_type must be specified whenever specifying t2
t2_type	empty	must be specified when specifying t2 possible values: raw - t2 is 32 byte hash decoded_address - t2 is an EVM address decoded_uint256 - t2is a decoded uint256

Param

Default value

Note

num

1000

if specified, value should be between 1 and 1000

empty

specifies the resume_token (obtained via the previous request) from which to fetch the next batch of event logs
resume_tokens are generated using an encoding safe for URLs and you should use it as is

empty

restricts logs to the specified topic0 hash
expected value if specified: full 32 byte hash

empty

restricts logs to the specified topic1 value
t1_type must be specified whenever specifying t1

t1_type

empty

must be specified when specifying t1
possible values:
- raw - t1 is 32 byte hash
- decoded_address - t1 is an EVM address
- decoded_uint256 - t1 is a decoded uint256

empty

restricts logs to the specified topic2 value
t2_type must be specified whenever specifying t2

t2_type

empty

must be specified when specifying t2
possible values:
- raw - t2 is 32 byte hash
- decoded_address - t2 is an EVM address
- decoded_uint256 - t2is a decoded uint256

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"
}

PreviousPoint-in-time balances

Last updated 3 months ago