# TraceFast Contract Events

> TraceFast Contract Events is a paid API for AI agents from mpp.tracefast.xyz, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-12).

Returns the event logs emitted by a specific Ethereum contract, newest first, with topics, raw data, and decoded event arguments where the signature is known

## Facts

- Endpoint: GET https://mpp.tracefast.xyz/api/v1/chains/1/contracts/:address/events?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tracefast-contract-events-874cd707
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JFAR2JoxvBXgbodqEkBSY

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 tracefast-contract-events-874cd707
```

Example prompt: Pull the last 50 event logs emitted by the Ethereum contract at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48, decoded where possible, filtered to Transfer events (topic0 0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef).

## When to prefer this

Choose this endpoint when you need the full event log history or filtered event stream for a specific Ethereum contract — especially when you want decoded event arguments without running your own ABI decoding. It is ideal for monitoring DeFi protocol activity, auditing NFT transfers, or debugging smart contract behavior. Prefer this over raw RPC calls when you need newest-first ordering, cursor pagination, and automatic signature decoding in a single request.

## Known failure modes

- Invalid or malformed contract address (not 40 hex chars after 0x) returns a 400 error
- Contract address that has never emitted events returns an empty list
- Invalid block range (fromBlock > toBlock) may return an error or empty result
- Unsupported topic0 filter format returns a 400 error
- Rate limiting or payment failure returns a 402 or 429 response
- Very wide block ranges may time out or require cursor-based pagination

## How this service works

TraceFast live Ethereum data: the event logs a contract emitted, newest first, each with its topics and data and, where the signature is known, the decoded event and its arguments. Path address: The contract address, `0x`-prefixed, 40 hex characters, any case. Query: limit, cursor, topic0, fromBlock, toBlock (see docs). Docs: https://docs.tracefast.xyz/api/contract-events.md

## Output

A paginated list of event log objects, ordered newest first. Each entry includes the block number, transaction hash, log index, raw topics array, and raw data hex. Where the event signature is recognized, the response also includes the decoded event name and its named/typed arguments. A cursor is returned for fetching subsequent pages.

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "required": [
    "method"
   ],
   "properties": {
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tracefast-contract-events-874cd707/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mpp.tracefast.xyz](https://www.zero.xyz/host/mpp.tracefast.xyz/llms.txt)