# TraceFast ERC-20 Token Transfers by Address

> TraceFast ERC-20 Token Transfers by Address 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 paginated ERC-20 token transfer events sent or received by an Ethereum address, newest first, with contract-declared token metadata, raw unscaled amounts, counterparties, and originating transaction sender.

## Facts

- Endpoint: GET https://mpp.tracefast.xyz/api/v1/chains/1/entities/:address/token-transfers?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-erc-20-token-transfers-by-address-45d5be14
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1FIS5rtNnUeAQ8nnsrhD0

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-erc-20-token-transfers-by-address-45d5be14
```

Example prompt: Show me the last 50 ERC-20 token transfers received by Ethereum address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045, newest first, on mainnet.

## When to prefer this

Choose this endpoint when you need live, on-chain ERC-20 token transfer history for a specific Ethereum address — especially when you need the originating transaction sender (msg.sender) distinguished from the transfer parties, which is critical for tracing through routers, aggregators, or batch disbursers. Prefer this over general block explorers when you need clean, structured, paginated JSON output suitable for agent consumption, when filtering by specific token contracts or block ranges is needed, or when you need the raw unscaled amount alongside contract-declared token metadata.

## Known failure modes

- Invalid or malformed Ethereum address returns 400 error
- Unknown chain ID or unsupported network returns 404
- fromBlock greater than toBlock returns validation error
- Expired or invalid pagination cursor returns error
- Rate limit or payment failure (x402) blocks the request
- Address with no token transfer history returns empty results array
- Very broad block ranges may time out or return partial results

## How this service works

TraceFast live Ethereum data: the token transfers an address sent or received, newest first — the token as its contract declares itself, the raw amount (unscaled), the parties, the transaction that emitted it and who sent that transaction, which on a router or a batch disburser is another party entirely. Path: address. Query: limit, cursor, direction, token, fromBlock, toBlock (see docs). Docs: https://docs.tracefast.xyz/api/entity-token-transfers.md

## Output

A paginated list of ERC-20 token transfer events for the queried address, ordered newest first. Each record includes the token contract address with its self-declared name and symbol, the raw (unscaled) transfer amount, the from and to addresses of the transfer, the transaction hash that emitted the event, the block number, and the msg.sender of the originating transaction (which may differ from the transfer sender in router/batch disbursement scenarios). A cursor is provided for 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-erc-20-token-transfers-by-address-45d5be14/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)
