# Farcaster Signal — Base Token Social Score

> Farcaster Signal — Base Token Social Score is a paid API for AI agents from x402-farcaster-social-signal-production.up.railway.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Returns a composite social signal score for a Base ERC-20 token by combining onchain activity with Farcaster cast engagement metrics.

## Facts

- Endpoint: POST https://x402-farcaster-social-signal-production.up.railway.app/token/social-signal
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/farcaster-signal-base-token-social-score-225b05ad
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_q0isrf3yEzGS1UruKBJgG

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 farcaster-signal-base-token-social-score-225b05ad -d '<json body>'
```

Example prompt: What's the Farcaster social signal score for DEGEN on Base over the last 48 hours — how many casts and unique authors are talking about it?

## When to prefer this

Use this endpoint when you need to quantify social momentum of a specific Base ERC-20 token using Farcaster engagement data. Ideal for crypto research agents evaluating token hype, traders assessing social sentiment before a trade, or dashboards ranking Base tokens by community activity. Prefer over generic social listening tools when the target chain is Base and the social layer is Farcaster specifically.

## Known failure modes

- Unknown token symbol — no matching Base token found, returns empty or error
- Invalid contract address format — returns validation error
- No Farcaster activity found for the token in the lookback window — returns score of 0 with empty topCasts
- hoursBack value too large — may time out or return partial data
- Payment failure — x402 payment not accepted, returns 402

## How this service works

Farcaster social signal score for a token on Base — combines onchain activity with social engagement.

## Output

Returns a JSON object with the token's metadata (name, symbol, decimals), a social signal object containing a composite score (0-100), total cast count, and unique author count, plus an array of top relevant casts from Farcaster within the lookback window.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "symbol": {
   "type": "string",
   "description": "Token symbol, used if contractAddress is omitted"
  },
  "hoursBack": {
   "type": "number",
   "description": "Lookback window in hours (default 24)"
  },
  "contractAddress": {
   "type": "string",
   "description": "ERC-20 token contract address on Base"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "token": {
   "name": "USD Coin",
   "symbol": "USDC",
   "decimals": 6
  },
  "topCasts": [],
  "socialSignal": {
   "score": 61,
   "castCount": 25,
   "uniqueAuthorCount": 23
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/farcaster-signal-base-token-social-score-225b05ad/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-farcaster-social-signal-production.up.railway.app](https://www.zero.xyz/host/x402-farcaster-social-signal-production.up.railway.app/llms.txt)