GET
/
v1
/
networks
/
{network_id}
/
smart_contracts
/
{contract_address}
/
events
List smart contract events
curl --request GET \
  --url https://api.cdp.coinbase.com/platform/v1/networks/{network_id}/smart_contracts/{contract_address}/events \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "network_name": "base-mainnet",
      "protocol_name": "uniswap",
      "contract_name": "Pool",
      "event_name": "Transfer",
      "sig": "Transfer(address,address,uint256)",
      "fourBytes": "0xddf252ad",
      "contract_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "block_time": "2023-04-01T12:00:00Z",
      "block_height": 201782330,
      "tx_hash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
      "tx_index": 109,
      "event_index": 362,
      "data": "{\"from\":\"0x1234...\",\"to\":\"0x5678...\",\"value\":\"1000000000000000000\"}"
    }
  ],
  "next_page": "eyJsYXN0X2V2ZW50X2lkIjoiMTIzNDU2Nzg5MCJ9",
  "has_more": true
}

Authorizations

​
Authorization
string
header
required

Enter your JSON Web Token (JWT) here. Refer to the Generate JWT section of our Authentication docs for information on how to generate your Bearer Token.

Path Parameters

​
network_id
string
required

Blockchain network identifier.

​
contract_address
string
required

EVM address of the smart contract.

Query Parameters

​
protocol_name
string
required

Case-sensitive name of the blockchain protocol.

​
contract_name
string
required

Case-sensitive name of the specific contract within the project.

​
event_name
string
required

Case-sensitive name of the event to filter for in the contract's logs.

​
from_block_height
integer
required

Lower bound of the block range to query (inclusive).

​
to_block_height
integer
required

Upper bound of the block range to query (inclusive)

​
next_page
string

Pagination token for retrieving the next set of results.

Response

Successful response

A list of contract events with pagination information

​
data
object[]
required

An array of ContractEvent objects

​
next_page
string
required

The page token to be used to fetch the next page

Example:

"eyJsYXN0X2V2ZW50X2lkIjoiMTIzNDU2Nzg5MCJ9"

​
has_more
boolean
required

True if this list has another page of items after this one that can be fetched

Example:

true