Events

List on-chain events touching your watched addresses

GET/v1/events

Events where a watched address is the sender or the recipient, whether or not a rule matched.

Authentication: API key (Authorization: Bearer)
Required scope: read

Cursor-paginated list: see Pagination.

Query parameters#

chain_idinteger · int64
EVM chain id: 56 BNB Chain, 1 Ethereum, 8453 Base, 42161 Arbitrum One, 137 Polygon, 728126428 TRON.
sincestring
ISO 8601 date or date-time, inclusive (e.g. 2026-11-01T00:00:00Z).
untilstring
ISO 8601 date or date-time, exclusive.
limitinteger
Default 50
1 to 100
cursorstring
Opaque next_cursor of the previous page.

Responses#

200One page of events.

Object fields

dataarray of objectrequired
Fields of each item
- idstring · uuid
- chain_idinteger
- block_numberinteger
- block_hashstring
- block_timestampstring · date-timenullable
- tx_hashstring
- sourcestring
  balance: event derived from a balance reading (balance rules).
  
  Values log tx trace balance
- source_indexinteger
- typestring
  e.g. erc20_transfer, native_transfer.
- contractstringnullable
- fromstringnullable
- tostringnullable
- tokenstringnullable
- amountstringnullable
  Raw integer amount (smallest unit), as a string.
- statusstring
  Values pending confirmed orphaned
- payloadobject
- created_atstring · date-time
has_morebooleanrequired
next_cursorstringrequirednullable

4xx · 5xxError.

Standard error format: see Errors.

Request

cURL

curl "https://aicscan.io/v1/events?chain_id=56&limit=20" \
  -H "Authorization: Bearer $AICSCAN_API_KEY"

JavaScript

const res = await fetch('https://aicscan.io/v1/events?chain_id=56&limit=20', {
  headers: {
    Authorization: `Bearer ${process.env.AICSCAN_API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

Python

import os
import requests

resp = requests.get(
    "https://aicscan.io/v1/events?chain_id=56&limit=20",
    headers={
        "Authorization": f"Bearer {os.environ['AICSCAN_API_KEY']}",
    },
    timeout=10,
)
resp.raise_for_status()
print(resp.json())

Response 200

JSON

{
  "data": [
    {
      "id": "0193a1c9-3e02-7f3a-9b4c-5d6e7f8091a2",
      "chain_id": 56,
      "block_number": 45123456,
      "block_hash": "0x5f1c0a7e9d3b2c4a6e8f0d1b3c5a7e9f1d3b5c7a9e1f3d5b7c9a1e3f5d7b9c1a",
      "block_timestamp": "2026-11-14T09:30:12Z",
      "tx_hash": "0x9a8b7c6d5e4f30211203f4e5d6c7b8a99a8b7c6d5e4f30211203f4e5d6c7b8a9",
      "source": "log",
      "source_index": 211,
      "type": "erc20_transfer",
      "contract": "0x55d398326f99059ff775485246999027b3197955",
      "from": "0x8894e0a0c962cb723c1976a4421c95949be2d4e3",
      "to": "0x77cd0000000000000000000000000000000001e2",
      "token": "0x55d398326f99059ff775485246999027b3197955",
      "amount": "250000000000000000000000",
      "status": "confirmed",
      "payload": {},
      "created_at": "2026-11-14T09:30:13.402Z"
    }
  ],
  "has_more": true,
  "next_cursor": "0193a1b25c3d7e4f8a9b0c1d2e3f4a5b"
}