# Blockscout Address Event Logs

> Blockscout Address Event Logs is a paid API for AI agents from api.blockscout.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Retrieves paginated event logs emitted by or involving a specific blockchain address on a given chain

## Facts

- Endpoint: GET https://api.blockscout.com/:chain_id/api/v2/addresses/:address_hash_param/logs
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockscout-address-event-logs-15d38602
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_x4RNxcNDlXPvY_NmbZPk8

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability blockscout-address-event-logs-15d38602
```

Example prompt: Pull up all the event logs for the smart contract at 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Ethereum mainnet (chain ID 1) — I want to see what events it has emitted, starting from block 18000000.

## When to prefer this

Choose this endpoint when you need on-chain event log history for a specific address on any EVM-compatible chain supported by Blockscout, especially when you want multichain coverage without running your own node. Prefer it over Etherscan-style APIs when you need open, decentralized block explorer data with per-call micropayment pricing. It is well-suited for smart contract auditing, DeFi monitoring, and event-driven workflows that require historical log data filtered by address and optionally by topic or block range.

## Known failure modes

- Invalid or malformed address hash returns 400 or empty result
- Unsupported or unknown chain_id returns 404 or error
- Topic filter with invalid hex string may return empty logs or error
- Pagination index out of range returns empty items array
- Rate limiting or payment issues return 402 or 429
- Network or node unavailability causes 503 timeout

## How this service works

Access to api/v2/addresses/:address_hash/logs. List event logs emitted by or involving a specific address

## Output

Returns a paginated list of event log entries associated with the given address on the specified chain. Each log entry typically includes the transaction hash, block number, log index, topics array (event signature and indexed parameters), raw data field, and the emitting contract address. Pagination is supported via index and items_count parameters.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "properties": {
      "chain_id": {
       "type": "string"
      },
      "address_hash_param": {
       "type": "string"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "index": {
       "type": "integer"
      },
      "topic": {
       "type": "string"
      },
      "items_count": {
       "type": "integer"
      },
      "block_number": {
       "type": "integer"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockscout-address-event-logs-15d38602/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.blockscout.com](https://www.zero.xyz/host/api.blockscout.com/llms.txt)