Skip to main content
GET
/
v1
/
evm
/
activity
/
{address}
Get EVM activity for a given address
curl --request GET \
  --url https://api.sim.dune.com/v1/evm/activity/{address} \
  --header 'X-Sim-Api-Key: <x-sim-api-key>'
{
  "activity": [
    {
      "chain_id": 8453,
      "block_number": 26635101,
      "block_time": "2025-02-20T13:52:29+00:00",
      "tx_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"
}
Activity Sv The Activity API provides a realtime feed of onchain activity for any EVM address. The newest activity is returned first and includes the following activity types:
  • send - Outgoing transfers of tokens or native assets
  • receive - Incoming transfers of tokens or native assets
  • mint - Token minting activities
  • burn - Token burning activities
  • swap - Token swaps and exchanges
  • approve - Token approval transactions
  • call - Generic contract interactions that don’t fall into the above categories
Each activity includes detailed information such as:
  • Native token transfers
  • ERC20 token transfers with metadata (symbol, decimals)
  • ERC721 (NFT) transfers with token IDs
  • Contract interactions with decoded function calls
Activities are mostly indexed events. There are, of course, no events for native token transfers (wen 7708?). We do have a heuristic to catch very simple native token transfers, where the native token transfer is the entirety of the transaction, but unfortunately we don’t currently catch native token transfers that happen within internal txns.

​
Data Finality & Re-orgs

Sim APIs are designed to automatically detect and handle blockchain re-organizations. We detect any potentially broken parent-child block relationships as soon as they arise and update our internal state to match the onchain state, typically within a few hundred milliseconds. This re-org handling is an automatic, non-configurable feature designed to provide the most reliable data.

​
Token Filtering

We include all the data needed for custom filtering in the responses, allowing you to implement your own filtering logic. For a detailed explanation of our approach, see our Token Filtering guide.

​
Compute Unit Cost

The Activity endpoint has a fixed CU cost of 3 per request. See the Compute Units page for detailed information.

Headers

​
X-Sim-Api-Key
string
required

Used for authenticating requests. Provide an API key with a purpose of Sim API. See Authentication.

Path Parameters

​
address
string
default:0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
required

Wallet address to get activity for

Query Parameters

​
chain_ids
string

Filter by chain(s). Accepts a single numeric chain ID (e.g. ?chain_ids=1), a single chain name (e.g. ?chain_ids=ethereum), or a comma separated list of either (e.g. ?chain_ids=1,137 or ?chain_ids=ethereum,polygon). If omitted, results include activity from chains with the "default" tag for the address. See the Supported Chains Tags section.

​
offset
string

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
default:20

Maximum number of activity items to return. Default is 20 when not provided. Values above 100 are reduced to 100.

Required range: 1 <= x <= 100

Response

Successful Response

​
activity
object[]
required

Array of activity items

​
next_offset
string

Pagination cursor for the next page of results

⌘I