# Axiom Works ERC20 Transfer Events

> Axiom Works ERC20 Transfer Events is a paid API for AI agents from api.axiomworks.co.uk, paid per call via x402, $0.003/call, status unknown (last checked 2026-11-12).

Fetches decoded ERC20 Transfer events (from, to, amount, tx hash, block) for a given token contract and/or wallet address on EVM chains via eth_getLogs

## Facts

- Endpoint: GET https://api.axiomworks.co.uk/chain/erc20-transfers?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/axiom-works-erc20-transfer-events-466855b2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Ua-imPf0-nRVGxMZaQlcM

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 axiom-works-erc20-transfer-events-466855b2
```

Example prompt: Can you check whether a USDC payment arrived at wallet 0x88b1c747c33A5868A34057D8C57318E5602b3ff6 on Base in the last 500 blocks — I'm looking for any incoming transfers from token contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?

## When to prefer this

Use this endpoint when you need decoded, human-readable ERC20 transfer history for a specific token or wallet without running your own node. It is especially suited for confirming incoming payments, auditing token flows, and monitoring on-chain activity across Base, Ethereum, Arbitrum, Optimism, and Polygon. It is superior to raw eth_getLogs calls because it decodes amounts with proper decimals and returns structured JSON ready for agent consumption. For checking a single transaction's status use the transaction confirmation endpoint; for wallet balance snapshots use the balances endpoint.

## Known failure modes

- Invalid or non-checksummed token/address returns a 400 validation error
- Requesting blocks beyond the 5000-block maximum returns an error or truncated result
- Unsupported chain value returns a 400 enum validation error
- No matching transfers in the requested range returns an empty transfers array with count 0
- Rate limiting or payment failure returns a 402 Payment Required
- Very high-activity tokens with many events may hit the 200-item limit even within the block window

## How this service works

ERC20 Transfer events for a token and/or wallet via eth_getLogs, decoded (from, to, amount with decimals, tx hash, block). Default last 1000 blocks, max 5000. Example: {token:"0x8335…2913", address:"0x88b1…3ff6", chain:"base"} → newest first. Use it to confirm incoming payments. $0.003.

## Output

A JSON object containing the chain, scanned block range (from_block, to_block), total_matched count, and an array of decoded Transfer events sorted newest first. Each transfer includes the sender address (from), recipient address (to), human-readable token amount with symbol (e.g. '0.01 USDC'), raw amount, transaction hash (tx), block number, log index, and token contract address.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "chain": {
       "enum": [
        "base",
        "ethereum",
        "arbitrum",
        "optimism",
        "polygon"
       ],
       "type": "string",
       "description": "EVM chain (default base)"
      },
      "limit": {
       "type": "string",
       "description": "Max items (default 50, max 200)"
      },
      "token": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "ERC20 contract (recommended; required unless scanning known tokens for a wallet)"
      },
      "blocks": {
       "type": "string",
       "description": "Lookback blocks (default 100, max 5000)"
      },
      "wallet": {
       "type": "string",
       "description": "Alias for address (owner wallet)"
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Wallet to filter (optional if token given)"
      },
      "to_block": {
       "type": "string"
      },
      "direction": {
       "enum": [
        "in",
        "out",
        "any"
       ],
       "type": "string"
      },
      "from_block": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "count": {
       "type": "number"
      },
      "to_block": {
       "type": "number"
      },
      "transfers": {
       "type": "array"
      },
      "from_block": {
       "type": "number"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "base",
  "count": 29,
  "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "source": "eth_getLogs Transfer(address,address,uint256)",
  "address": "0x88b1c747c33A5868A34057D8C57318E5602b3ff6",
  "chain_id": 8453,
  "to_block": 53552083,
  "direction": "any",
  "transfers": [
   {
    "to": "0x88b1c747c33a5868a34057d8c57318e5602b3ff6",
    "tx": "0x5cdcc3b513e329cc0e6121b25b4ee07082274ef323a0a6256361f6f0756c06a9",
    "from": "0xdefe5f9f39d0f0a5f3c83594cd65a8e70015b370",
    "block": 53551892,
    "token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
    "amount": "0.01",
    "symbol": "USDC",
    "log_index": 844,
    "amount_raw": "10000"
   },
   {
    "to": "0x88b1c747c33a5868a34057d8c57318e5602b3ff6",
    "tx": "0x18bd39f2a187db8d08918793e9c7f18ccb8e54730de104fe7122acf63414323c",
    "from": "0xdefe5f9f39d0f0a5f3c83594cd65a8e70015b370",
    "block": 53551891,
    "token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
    "amount": "0.005",
    "symbol": "USDC",
    "log_index": 1147,
    "amount_raw": "5000"
   }
  ],
  "from_block": 53551083,
  "total_matched": 29
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/axiom-works-erc20-transfer-events-466855b2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.axiomworks.co.uk](https://www.zero.xyz/host/api.axiomworks.co.uk/llms.txt)
