# Tokentx – ERC-20 Token Transfers by Address

> Tokentx – ERC-20 Token Transfers by Address is a paid API for AI agents from stablecrypto.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Retrieves ERC-20 token transfer history for a given wallet address on any EVM-compatible chain, with optional filtering by token contract, block range, and pagination.

## Facts

- Endpoint: POST https://stablecrypto.dev/api/etherscan/account/tokentx
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokentx-erc-20-token-transfers-by-address-13cfd105
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bK84Gq3z8WdZlGxABEJ6b

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 tokentx-erc-20-token-transfers-by-address-13cfd105 -d '<json body>'
```

Example prompt: Can you pull all ERC-20 token transfers for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum mainnet (chain ID 1), sorted from oldest to newest?

## When to prefer this

Use this endpoint when you need ERC-20 token transfer history for a specific wallet address on an EVM chain. Prefer it over generic RPC passthrough when you want structured, pre-parsed token transfer records with token metadata (name, symbol, decimals). It is especially useful for auditing wallet activity, tracking specific token flows, or building transaction history features without parsing raw logs.

## Known failure modes

- Invalid or malformed wallet address returns an error or empty result
- Unsupported chain ID returns an error or no data
- Block range with no matching transfers returns an empty list
- Rate limiting or payment failure returns a 402 or 429 response
- Invalid contract address filter returns empty results or an error

## How this service works

Pay-per-request access to CoinGecko, DefiLlama, Alchemy, and Etherscan APIs. No auth, no subscriptions.

## Output

Returns a list of ERC-20 token transfer events associated with the specified wallet address, including transaction hash, block number, timestamp, sender, recipient, token contract address, token name, symbol, decimals, and amount transferred. Results can be paginated and filtered by token contract or block range.

## Example request

```json
{
 "page": 1,
 "sort": "asc",
 "offset": 10,
 "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
 "chainid": 1
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "page": {
   "type": "number"
  },
  "sort": {
   "enum": [
    "asc",
    "desc"
   ],
   "type": "string"
  },
  "offset": {
   "type": "number"
  },
  "address": {
   "type": "string",
   "description": "Wallet address"
  },
  "chainid": {
   "type": "number",
   "description": "EVM chain ID (1=Ethereum, 137=Polygon, 8453=Base, etc.)"
  },
  "endblock": {
   "type": "number"
  },
  "startblock": {
   "type": "number"
  },
  "contractaddress": {
   "type": "string",
   "description": "Filter by token contract"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokentx-erc-20-token-transfers-by-address-13cfd105/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablecrypto.dev](https://www.zero.xyz/host/stablecrypto.dev/llms.txt)