# social-trending

> social-trending is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns a ranked cross-source crypto attention index fusing Farcaster cashtag mentions, crypto-news counts, and GDELT macro coverage trends into scored, velocity-tagged ticker rows

## Facts

- Endpoint: GET https://payai.agentstools.dev/social/trending
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/social-trending-745728c9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Lr5eeub1sNktZ-v0sCC8b

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 social-trending-745728c9
```

Example prompt: What crypto tickers are trending hardest on social right now? Give me the top 20 by cross-source attention score, including their velocity and which channels are driving them.

## When to prefer this

Use this endpoint when you need a ToS-compliant, multi-source crypto social attention signal without scraping Twitter or Reddit. It is the right choice when you want a single ranked signal that fuses Farcaster community chatter, crypto news mentions, and macro news coverage rather than any single source. Prefer it over raw feed endpoints when you need velocity (momentum), channel attribution, and sentiment already computed.

## Known failure modes

- No trending tickers detected if data sources are temporarily unavailable
- limit parameter out of range (1–40) returns validation error
- Stale data if upstream Farcaster/news/GDELT feeds lag
- Payment not settled (x402) results in 402 response blocking the call
- Empty result set during low-activity market periods

## How this service works

What crypto tickers are heating up across crypto social right now: a ranked cross-source attention index fusing Farcaster cashtag mentions across curated crypto channels (keyless open-protocol hub) with crypto-news mention counts and a GDELT macro coverage-trend. Each row carries an attention score, a recent-vs-prior velocity, the channels driving it and cast sentiment — signal, not a raw feed. ToS-clean (no Twitter/Reddit).

## Output

A ranked list of up to 40 crypto tickers (default 15), each with an attention score, recent-vs-prior velocity, the Farcaster channels and news sources driving attention, and cast sentiment — all fused from Farcaster cashtag mentions, crypto-news mention counts, and GDELT macro coverage trends.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "limit": {
       "type": "integer",
       "maximum": 40,
       "minimum": 1,
       "description": "Max ranked tickers to return (default 15)."
      },
      "window": {
       "type": "string",
       "description": "Reserved velocity-window hint; velocity uses recency-rank windows (see response)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/social-trending-745728c9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)