Get Logs Events

Get all transactions logs between specified blocks

Get Log events by topics

This endpoint allows to fetch all log events for a specified topic/s between a specified blocks.

Filters:

```
    Get All Logs between specified blocks
```
Block filtering, return all logs between those blocks, If fromBlock and toBlocks are not specified then the recent 5 block logs will be returned. (fromBlock specifies from which block logs should be picked, toBlock specifies till which block)

Request

Security:

auth_key

path Parameters

chain

required

string

Chain name (example: bsc, ethereum, matic...)

Enum: "ethereum" "bsc" "matic" "celo" "avalanche" "xinfin" "zilliqa" "fantom" "bsc-testnet" "matic-testnet" "rinkeby-testnet"

Example: bsc

query Parameters

topics required	string Default: "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef" Topics which are to be filtered in logs Example: topics=0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
fromBlock	number Default: 14870135 Starting block from which the transactions should be considered Example: fromBlock=14870135
toBlock	number Default: 14870140 End block till which the transactions should be considered Example: toBlock=14870140

Responses

200

401

get/v1/{chain}/topics/logs

Request samples

curl -i -X GET \
  'https://api.unmarshal.com/v1/:chain/topics/logs?topics=0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef&fromBlock=14870135&toBlock=14870140&auth_key=YOUR_API_KEY_HERE'

Response samples

application/json

[{"address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
"topics": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x0000000000000000000000006fa0ae33263e500a6aba7535e5837c8766769847",
"0x000000000000000000000000737046ef759691fbc778cd59fdec77b1534c39a5"
],
"data": "0x0000000000000000000000000000000000000000000000003526dd6e8c968000",
"blockNumber": "0x1198a78",
"transactionHash": "0xe6fe847a3742cdbca295fecc001d25509781ed88028ca8db917f88991f0db0bf",
"transactionIndex": "0x0",
"blockHash": "0xd555b23a9bbea80c203b624d70a3f702439bd1f5d1d6402547f6ad69638024cf",
"logIndex": "0x0",
"removed": false
},
{"address": "0x26193c7fa4354ae49ec53ea2cebc513dc39a10aa",
"topics": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x000000000000000000000000737046ef759691fbc778cd59fdec77b1534c39a5",
"0x0000000000000000000000006fa0ae33263e500a6aba7535e5837c8766769847"
],
"data": "0x0000000000000000000000000000000000000000000009527d94da97cced1b24",
"blockNumber": "0x1198a78",
"transactionHash": "0xe6fe847a3742cdbca295fecc001d25509781ed88028ca8db917f88991f0db0bf",
"transactionIndex": "0x0",
"blockHash": "0xd555b23a9bbea80c203b624d70a3f702439bd1f5d1d6402547f6ad69638024cf",
"logIndex": "0x1",
"removed": false
},
{"address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
"topics": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x0000000000000000000000008fb70a8a791b2454c33f199ef6fe0a136af75710",
"0x000000000000000000000000737046ef759691fbc778cd59fdec77b1534c39a5"
],
"data": "0x000000000000000000000000000000000000000000000000b469471f80140000",
"blockNumber": "0x1198a78",
"transactionHash": "0x0f4f695d32cc9221f46bd0bbeff33ab03c5f53bddf99f79c4ab476945c34d78f",
"transactionIndex": "0x3",
"blockHash": "0xd555b23a9bbea80c203b624d70a3f702439bd1f5d1d6402547f6ad69638024cf",
"logIndex": "0x4",
"removed": false
}
]

Get Log events by contract address

This endpoint allows to fetch all the log events for a specified contract between a specified blocks. Also this provides a decoded logs events.

Filters:

```
    Get All Logs between specified blocks
```
Block filtering, return all logs between those blocks, If fromBlock and toBlocks are not specified then the recent 5 block logs will be returned. (fromBlock specifies from which block logs should be picked, toBlock specifies till which block)

Request

Security:

auth_key

path Parameters

chain required	string Chain name (example: bsc, ethereum, matic...) Enum: "ethereum" "bsc" "matic" "celo" "avalanche" "xinfin" "zilliqa" "fantom" "bsc-testnet" "matic-testnet" "rinkeby-testnet" Example: bsc
address required	string Default: "0x2fa5daf6fe0708fbd63b1a7d1592577284f52256" Any valid Contract address Example: 0x2fa5daf6fe0708fbd63b1a7d1592577284f52256

query Parameters

fromBlock	number Default: 14870135 Starting block from which the transactions should be considered Example: fromBlock=14870135
toBlock	number Default: 14870140 End block till which the transactions should be considered Example: toBlock=14870140

Request Body schema: application/json

contract_abi

required

string

Responses

200

401

post/v1/{chain}/contract/{address}/logs

Request samples

application/json

{"contract_abi": "[\n    {\n        \"inputs\": [\n            {\n                \"internalType\": \"string\",\n                \"name\": \"name\",\n                \"type\": \"string\"\n            },\n            {\n                \"internalType\": \"string\",\n                \"name\": \"symbol\",\n                \"type\": \"string\"\n            },\n            {\n                \"internalType\": \"uint8\",\n                \"name\": \"decimals\",\n                \"type\": \"uint8\"\n            }\n        ],\n        \"stateMutability\": \"nonpayable\",\n        \"type\": \"constructor\"\n    },\n    {\n        \"anonymous\": false,\n        \"inputs\": [\n            {\n                \"indexed\": true,\n                \"internalType\": \"address\",\n                \"name\": \"owner\",\n                \"type\": \"address\"\n            },\n            {\n                \"indexed\": true,\n                \"internalType\": \"address\",\n                \"name\": \"spender\",\n                \"type\": \"address\"\n            },\n            {\n                \"indexed\": false,\n                \"internalType\": \"uint256\",\n                \"name\": \"value\",\n                \"type\": \"uint256\"\n            }\n        ],\n        \"name\": \"Approval\",\n        \"type\": \"event\"\n    },\n    {\n        \"anonymous\": false,\n        \"inputs\": [\n            {\n                \"indexed\": true,\n                \"internalType\": \"address\",\n                \"name\": \"previousOwner\",\n                \"type\": \"address\"\n            },\n            {\n                \"indexed\": true,\n                \"internalType\": \"address\",\n                \"name\": \"newOwner\",\n                \"type\": \"address\"\n            }\n        ],\n        \"name\": \"OwnershipTransferred\",\n        \"type\": \"event\"\n    },\n    {\n        \"anonymous\": false,\n        \"inputs\": [\n            {\n                \"indexed\": true,\n                \"internalType\": \"address\",\n                \"name\": \"from\",\n                \"type\": \"address\"\n            },\n            {\n                \"indexed\": true,\n                \"internalType\": \"address\",\n                \"name\": \"to\",\n                \"type\": \"address\"\n            },\n            {\n                \"indexed\": false,\n                \"internalType\": \"uint256\",\n                \"name\": \"value\",\n                \"type\": \"uint256\"\n            }\n        ],\n        \"name\": \"Transfer\",\n        \"type\": \"event\"\n    },\n    {\n        \"inputs\": [\n            {\n                \"internalType\": \"address\",\n                \"name\": \"owner\",\n                \"type\": \"address\"\n            },\n            {\n                \"internalType\": \"address\",\n                \"name\": \"spender\",\n                \"type\": \"address\"\n            }\n        ],\n        \"name\": \"allowance\",\n        \"outputs\": [\n            {\n                \"internalType\": \"uint256\",\n                \"name\": \"\",\n                \"type\": \"uint256\"\n            }\n        ],\n        \"stateMutability\": \"view\",\n        \"type\": \"function\"\n    },\n    {\n        \"inputs\": [\n            {\n                \"internalType\": \"address\",\n                \"name\": \"spender\",\n                \"type\": \"address\"\n            },\n            {\n                \"internalType\": \"uint256\",\n                \"name\": \"amount\",\n                \"type\": \"uint256\"\n            }\n        ],\n        \"name\": \"approve\",\n        \"outputs\": [\n            {\n                \"internalType\": \"bool\",\n                \"name\": \"\",\n                \"type\": \"bool\"\n            }\n        ],\n        \"stateMutability\": \"nonpayable\",\n        \"type\": \"function\"\n    },\n    {\n        \"inputs\": [\n            {\n                \"internalType\": \"address\",\n                \"name\": \"account\",\n                \"type\": \"address\"\n            }\n        ],\n        \"name\": \"balanceOf\",\n        \"outputs\": [\n            {\n                \"internalType\": \"uint256\",\n                \"name\": \"\",\n                \"type\": \"uint256\"\n            }\n        ],\n        \"stateMutability\": \"view\",\n        \"type\": \"function\"\n    },\n    {\n        \"inputs\": [\n            {\n                \"internalType\": \"uint256\",\n                \"name\": \"amount\",\n                \"type\": \"uint256\"\n            }\n        ],\n        \"name\": \"burn\",\n        \"outputs\": [],\n        \"stateMutability\": \"nonpayable\",\n        \"type\": \"function\"\n    },\n    {\n        \"inputs\": [],\n        \"name\": \"decimals\",\n        \"outputs\": [\n            {\n                \"internalType\": \"uint8\",\n                \"name\": \"\",\n                \"type\": \"uint8\"\n            }\n        ],\n        \"stateMutability\": \"view\",\n        \"type\": \"function\"\n    },\n    {\n        \"inputs\": [\n            {\n                \"internalType\": \"address\",\n                \"name\": \"spender\",\n                \"type\": \"address\"\n            },\n            {\n                \"internalType\": \"uint256\",\n                \"name\": \"subtractedValue\",\n                \"type\": \"uint256\"\n            }\n        ],\n        \"name\": \"decreaseAllowance\",\n        \"outputs\": [\n            {\n                \"internalType\": \"bool\",\n                \"name\": \"\",\n                \"type\": \"bool\"\n            }\n        ],\n        \"stateMutability\": \"nonpayable\",\n        \"type\": \"function\"\n    },\n    {\n        \"inputs\": [\n            {\n                \"internalType\": \"address\",\n                \"name\": \"spender\",\n                \"type\": \"address\"\n            },\n            {\n                \"internalType\": \"uint256\",\n                \"name\": \"addedValue\",\n                \"type\": \"uint256\"\n            }\n        ],\n        \"name\": \"increaseAllowance\",\n        \"outputs\": [\n            {\n                \"internalType\": \"bool\",\n                \"name\": \"\",\n                \"type\": \"bool\"\n            }\n        ],\n        \"stateMutability\": \"nonpayable\",\n        \"type\": \"function\"\n    },\n    {\n        \"inputs\": [\n            {\n                \"internalType\": \"address\",\n                \"name\": \"to\",\n                \"type\": \"address\"\n            },\n            {\n                \"internalType\": \"uint256\",\n                \"name\": \"amount\",\n                \"type\": \"uint256\"\n            }\n        ],\n        \"name\": \"mint\",\n        \"outputs\": [],\n        \"stateMutability\": \"nonpayable\",\n        \"type\": \"function\"\n    },\n    {\n        \"inputs\": [],\n        \"name\": \"name\",\n        \"outputs\": [\n            {\n                \"internalType\": \"string\",\n                \"name\": \"\",\n                \"type\": \"string\"\n            }\n        ],\n        \"stateMutability\": \"view\",\n        \"type\": \"function\"\n    },\n    {\n        \"inputs\": [],\n        \"name\": \"owner\",\n        \"outputs\": [\n            {\n                \"internalType\": \"address\",\n                \"name\": \"\",\n                \"type\": \"address\"\n            }\n        ],\n        \"stateMutability\": \"view\",\n        \"type\": \"function\"\n    },\n    {\n        \"inputs\": [],\n        \"name\": \"renounceOwnership\",\n        \"outputs\": [],\n        \"stateMutability\": \"nonpayable\",\n        \"type\": \"function\"\n    },\n    {\n        \"inputs\": [],\n        \"name\": \"symbol\",\n        \"outputs\": [\n            {\n                \"internalType\": \"string\",\n                \"name\": \"\",\n                \"type\": \"string\"\n            }\n        ],\n        \"stateMutability\": \"view\",\n        \"type\": \"function\"\n    },\n    {\n        \"inputs\": [],\n        \"name\": \"totalSupply\",\n        \"outputs\": [\n            {\n                \"internalType\": \"uint256\",\n                \"name\": \"\",\n                \"type\": \"uint256\"\n            }\n        ],\n        \"stateMutability\": \"view\",\n        \"type\": \"function\"\n    },\n    {\n        \"inputs\": [\n            {\n                \"internalType\": \"address\",\n                \"name\": \"recipient\",\n                \"type\": \"address\"\n            },\n            {\n                \"internalType\": \"uint256\",\n                \"name\": \"amount\",\n                \"type\": \"uint256\"\n            }\n        ],\n        \"name\": \"transfer\",\n        \"outputs\": [\n            {\n                \"internalType\": \"bool\",\n                \"name\": \"\",\n                \"type\": \"bool\"\n            }\n        ],\n        \"stateMutability\": \"nonpayable\",\n        \"type\": \"function\"\n    },\n    {\n        \"inputs\": [\n            {\n                \"internalType\": \"address\",\n                \"name\": \"to\",\n                \"type\": \"address\"\n            },\n            {\n                \"internalType\": \"uint256\",\n                \"name\": \"amount\",\n                \"type\": \"uint256\"\n            },\n            {\n                \"internalType\": \"bytes\",\n                \"name\": \"\",\n                \"type\": \"bytes\"\n            }\n        ],\n        \"name\": \"transferAndCall\",\n        \"outputs\": [\n            {\n                \"internalType\": \"bool\",\n                \"name\": \"\",\n                \"type\": \"bool\"\n            }\n        ],\n        \"stateMutability\": \"nonpayable\",\n        \"type\": \"function\"\n    },\n    {\n        \"inputs\": [\n            {\n                \"internalType\": \"address\",\n                \"name\": \"sender\",\n                \"type\": \"address\"\n            },\n            {\n                \"internalType\": \"address\",\n                \"name\": \"recipient\",\n                \"type\": \"address\"\n            },\n            {\n                \"internalType\": \"uint256\",\n                \"name\": \"amount\",\n                \"type\": \"uint256\"\n            }\n        ],\n        \"name\": \"transferFrom\",\n        \"outputs\": [\n            {\n                \"internalType\": \"bool\",\n                \"name\": \"\",\n                \"type\": \"bool\"\n            }\n        ],\n        \"stateMutability\": \"nonpayable\",\n        \"type\": \"function\"\n    },\n    {\n        \"inputs\": [\n            {\n                \"internalType\": \"address\",\n                \"name\": \"newOwner\",\n                \"type\": \"address\"\n            }\n        ],\n        \"name\": \"transferOwnership\",\n        \"outputs\": [],\n        \"stateMutability\": \"nonpayable\",\n        \"type\": \"function\"\n    }\n]"
}

Response samples

application/json

[{"address": "0x2FA5dAF6Fe0708fBD63b1A7D1592577284f52256",
"topics": ["0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x000000000000000000000000b954d485c329bd0fbfc881ae19f23b12cd3fdab2",
"0x000000000000000000000000bb38e1c9e6d61b51f2ef5f9290b29e86d9191fdf"
],
"data": "0x00000000000000000000000000000000000000000000001fe25c9b566b156cbd",
"blockNumber": 18301824,
"transactionHash": "0x61b648635870ced5bbb3f10c264ac666c7d4b93a50e3686e845f24115883f430",
"transactionIndex": 76,
"blockHash": "0xaafe16c41f85e95f993e1c9d4c45d8834f98affbb972c163ac35ac842e0c1aa7",
"logIndex": 209,
"decodedEvents": {"signature": "Transfer(address,address,uint256)",
"params": [{"name": "from",
"type": "address",
"indexed": true,
"value": "0xb954d485c329bd0fbfc881ae19f23b12cd3fdab2"
},
{"name": "to",
"type": "address",
"indexed": true,
"value": "0xbb38e1c9e6d61b51f2ef5f9290b29e86d9191fdf"
},
{"name": "value",
"type": "uint256",
"indexed": false,
"value": 588160149030891200000
}
]
}
}
]