GET

echo

beta

activity

evm

{address}

curl --request GET \
  --url https://api.dune.com/api/echo/beta/activity/evm/{address} \
  --header 'X-Dune-Api-Key: <x-dune-api-key>'

{
  "activity": [
    {
      "chain_id": 8453,
      "block_number": 26635101,
      "block_time": "2025-02-20T13:52:29+00:00",
      "transaction_hash": "0x184544c8d67a0cbed0a3f04abe5f958b96635e8c743c070f70e24b1c06cd1aa6",
      "type": "receive",
      "asset_type": "erc20",
      "token_address": "0xf92e740ad181b13a484a886ed16aa6d32d71b19a",
      "from": "0xd152f549545093347a162dce210e7293f1452150",
      "value": "123069652500000000000",
      "value_usd": 0.14017463965013963,
      "token_metadata": {
        "symbol": "ENT",
        "decimals": 18,
        "price_usd": 0.001138986230989314,
        "pool_size": 5.2274054439382835
      }
    }
  ],
  "next_offset": "KgAAAAAAAAAweDQ4ZDAwNGE2YzE3NWRiMzMxZTk5YmVhZjY0NDIzYjMwOTgzNTdhZTdAVxVC-y0GAAUhAAAAAAAA6XCRAQAAAAAAAAAAAAAAAD0AAAAAAAAAAAAAAAAAAAA"
}

This endpoint is currently in beta and requires authentication using a normal Dune API key.

The Activity endpoint provides a real-time feed of on-chain activity for any EVM address. Activity is returned in chronological order (newest first) and includes:

Native token transfers
ERC20 token transfers with metadata (symbol, decimals)
ERC721 (NFT) transfers with token IDs
Contract interactions with decoded function calls

Response Fields

Field	Description	Type
activity	Array of activity items	array
next_offset	Pagination cursor for next page	string

Activity Item Fields

Field	Description	Type
chain_id	ID of the blockchain where activity occurred	integer
block_number	Block number where activity occurred	integer
block_time	Unix timestamp of the block	integer
transaction_hash	Hash of the transaction	string
type	Activity type: ‘transfer’, ‘call’, or ‘mint’	string
asset_type	Asset type: ‘native’, ‘erc20’, or ‘erc721’	string
token_address	Contract address of token (for ERC20/ERC721)	string
from	Address initiating the activity	string
to	Recipient address	string
value	Amount transferred (in WEI) or contract call value	string
id	Token ID (for ERC721 transfers)	string
metadata	Additional context about the activity	object
metadata.symbol	Token symbol (for ERC20)	string
metadata.decimals	Token decimals (for ERC20)	integer
metadata.description	Human-readable description of the activity	string
function	Decoded function information (for contract calls)	object
function.name	Name of the called function	string
function.inputs	Array of decoded function parameters	array

Ordering

Activities are ordered by block time (descending) and then by transaction index within each block, so that newer activities appear first.

Pagination

This endpoint uses cursor-based pagination. You can use the limit parameter to define the maximum page size. Results might at times be less than the maximum page size. The next_offset value is included in the initial response and can be utilized to fetch the next page of results by passing it as the offset query parameter in the next request.

You can only use the value from next_offset to set the offset parameter of the next page of results. Using your own offset value will not have any effect.

Headers

X-Dune-Api-Key

string

required

API key to access the service

Path Parameters

address

string

required

Wallet to get activity for

Query Parameters

offset

string | null

The offset to paginate through result sets. This is a cursor being passed from the previous response, only use what the backend returns here.

limit

integer | null

Maximum number of activity items to return

Required range: x >= 0

Response

200

application/json

Successful Response

activity

object[]

required

Array of activity items

activity.chain_id

integer

ID of the blockchain where activity occurred

activity.block_number

integer

Block number where activity occurred

activity.block_time

string

Timestamp of the block

activity.transaction_hash

string

Hash of the transaction

activity.type

string

Activity type: 'transfer', 'call', 'mint', 'receive', 'send', 'swap', 'approve', etc.

activity.asset_type

string

Asset type: 'native', 'erc20', 'erc721', 'erc1155'

activity.token_address

string | null

Contract address of token (for ERC20/ERC721/ERC1155)

activity.from

string | null

Address initiating the activity

activity.to

string | null

Recipient address

activity.value

string | null

Amount transferred (in WEI) or contract call value

activity.value_usd

number | null

USD value of the transaction

activity.id

string | null

Token ID (for ERC721/ERC1155 transfers)

activity.spender

string | null

Address being approved to spend tokens (for approve activities)

activity.token_metadata

object | null

Additional token information

activity.function

object | null

Decoded function information (for contract calls)

activity.contract_metadata

object | null

Contract metadata

activity.from_token_address

string | null

Source token address (for swaps)

activity.from_token_value

string | null

Source token amount (for swaps)

activity.from_token_metadata

object | null

Source token metadata (for swaps)

activity.to_token_address

string | null

Destination token address (for swaps)

activity.to_token_value

string | null

Destination token amount (for swaps)

activity.to_token_metadata

object | null

Destination token metadata (for swaps)

next_offset

string | null

Pagination cursor for the next page of results

Was this page helpful?

Raise issue

Tokens (Beta)Token Balances (Beta)

curl --request GET \
  --url https://api.dune.com/api/echo/beta/activity/evm/{address} \
  --header 'X-Dune-Api-Key: <x-dune-api-key>'

{
  "activity": [
    {
      "chain_id": 8453,
      "block_number": 26635101,
      "block_time": "2025-02-20T13:52:29+00:00",
      "transaction_hash": "0x184544c8d67a0cbed0a3f04abe5f958b96635e8c743c070f70e24b1c06cd1aa6",
      "type": "receive",
      "asset_type": "erc20",
      "token_address": "0xf92e740ad181b13a484a886ed16aa6d32d71b19a",
      "from": "0xd152f549545093347a162dce210e7293f1452150",
      "value": "123069652500000000000",
      "value_usd": 0.14017463965013963,
      "token_metadata": {
        "symbol": "ENT",
        "decimals": 18,
        "price_usd": 0.001138986230989314,
        "pool_size": 5.2274054439382835
      }
    }
  ],
  "next_offset": "KgAAAAAAAAAweDQ4ZDAwNGE2YzE3NWRiMzMxZTk5YmVhZjY0NDIzYjMwOTgzNTdhZTdAVxVC-y0GAAUhAAAAAAAA6XCRAQAAAAAAAAAAAAAAAD0AAAAAAAAAAAAAAAAAAAA"
}

Dune Echo

Activity (Beta)

Response Fields

Activity Item Fields

Ordering

Headers

Path Parameters

Query Parameters

Response

Dune Echo

​Response Fields

​Activity Item Fields

​Ordering

​Pagination

Headers

Path Parameters

Query Parameters

Response

Response Fields

Activity Item Fields

Ordering

Pagination