# Zapper Token Activity Feed

> Zapper Token Activity Feed is a paid API for AI agents from public.zapper.xyz, paid per call via x402, $0.00375/call, status down (last checked 2026-10-12, last successful call 2026-05-27).

Returns a combined, paginated activity feed for a specific ERC20 token, mixing on-chain swaps with top Farcaster social casts, optionally personalized by Farcaster user ID.

## Facts

- Endpoint: POST https://public.zapper.xyz/x402/token-activity-feed?utm_source=zero.xyz
- Price: $0.00375/call
- Payment: x402
- Status: down
- Last checked: 2026-10-12
- Last successful call: 2026-05-27
- Success rate: 50% of calls made through Zero
- Activations on Zero: 2
- Tags: x402
- Canonical page: https://www.zero.xyz/c/public-zapper-xyz-c8f85517
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mZF8c-m8X64BiLOdsIutP

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 public-zapper-xyz-c8f85517 -d '<json body>'
```

Example prompt: Show me the DEFAULT activity feed for the USDC token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base (chain 8453), personalized for Farcaster user 12345, and only include swaps over $100 USD volume.

## When to prefer this

Use this endpoint when you need a unified view of both on-chain trading activity and Farcaster social sentiment for a specific token, especially when personalization by Farcaster identity is needed. Prefer this over generic swap history endpoints when social context matters, or over raw Farcaster search when on-chain swap data is also required.

## Known failure modes

- Invalid or unsupported chainId returns an error or empty feed
- Non-existent tokenAddress returns empty edges array
- Invalid FID format causes request rejection
- Filters with excessively high minimumUsdVolume may return empty results
- Pagination cursor mismatch or expiry may cause missing results
- Payment failure (x402) blocks the request entirely

## How this service works

Enterprise grade onchain data across 60+ chains - token prices, NFTs, portfolios, onchain search, Farcaster and more.

## Output

A paginated list of activity edges, each node being either a swap event (with isBuy flag, amount, volumeUsd, transactionHash) or a top Farcaster cast (with text, authorFid, hash), plus pageInfo cursors for pagination.

## Example request

```json
{
 "fid": 12345,
 "type": "DEFAULT",
 "chainId": 8453,
 "filters": {
  "minimumUsdVolume": 100
 },
 "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "fid": {
   "type": "integer",
   "description": "Optional Farcaster ID (FID) to personalize the feed"
  },
  "type": {
   "type": "string",
   "description": "Feed type (e.g. DEFAULT)"
  },
  "chainId": {
   "type": "integer",
   "description": "Chain ID of the token (e.g. 8453 for Base)"
  },
  "filters": {
   "type": "object",
   "properties": {
    "minimumUsdVolume": {
     "type": "number",
     "description": "Minimum USD volume threshold for swaps"
    }
   },
   "description": "Optional filters such as minimumUsdVolume"
  },
  "tokenAddress": {
   "type": "string",
   "description": "Contract address of the token"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/public-zapper-xyz-c8f85517/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from public.zapper.xyz](https://www.zero.xyz/host/public.zapper.xyz/llms.txt)