# x402stock Reddit Trending Tickers

> x402stock Reddit Trending Tickers is a paid API for AI agents from x402stock.xyz, paid per call via x402, $0.01/call, status healthy (last checked 2026-09-14, last successful call 2026-09-02).

Returns the most-mentioned stocks and/or crypto tickers on Reddit's major finance subreddits over the last 24 hours, ranked by mention volume with upvotes and rank-change data.

## Facts

- Endpoint: GET https://x402stock.xyz/api/v1/trending/reddit
- Price: $0.01/call
- Payment: x402
- Status: healthy
- Last checked: 2026-09-14
- Last successful call: 2026-09-02
- Success rate: 100% of calls made through Zero
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-xyz-a0f0f8aa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_BFkZaF1M_36pJGyNhwkqP

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 x402stock-xyz-a0f0f8aa
```

Example prompt: What stocks and crypto are Reddit talking about the most right now? Pull the top trending tickers from the last 24 hours across r/wallstreetbets and the other big finance subreddits — show me both stocks and crypto, page 1.

## When to prefer this

Use this endpoint when you need real-time social sentiment data from Reddit's major investment communities, particularly to detect retail-driven momentum or meme stock activity. Prefer this over general market data endpoints when the user wants to know what retail traders are talking about, not just price movements. It is especially useful for spotting emerging tickers gaining Reddit traction before they appear in mainstream financial data.

## Known failure modes

- Invalid filter value (not 'all', 'stocks', or 'crypto') returns a 400 error
- Page number out of range (>100 or <=0) returns a 400 error
- Payment not provided or insufficient USDC results in a 402 Payment Required response
- Upstream Reddit data temporarily unavailable may return stale or empty results
- Rate limiting or USDC payment processing failure returns a non-200 status

## How this service works

What stocks and crypto Reddit is talking about most over the last 24h, by mention volume across the busiest Reddit money subreddits (r/wallstreetbets, r/stocks, r/CryptoCurrency, r/Bitcoin, etc.). Each ticker carries mentions, upvotes, and 24h change in rank and mentions; covered subreddits are listed per response. ?filter=stocks|crypto|all (default all), ?page=. From x402stock

## Output

A paginated list of ticker symbols ranked by Reddit mention volume over the past 24 hours. Each entry includes ticker, company name, mention count, upvote count, current rank, rank 24 hours ago, mentions 24 hours ago, absolute and percent change in mentions, and rank change. The response also includes metadata: source, timestamp, filter applied, time window, covered subreddits, and pagination info (page, pages, count).

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "page": 1,
   "filter": "all"
  }
 }
}
```

## 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",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "filter",
      "page"
     ],
     "properties": {
      "page": {
       "type": "integer",
       "default": 1,
       "maximum": 100,
       "exclusiveMinimum": 0
      },
      "filter": {
       "enum": [
        "all",
        "stocks",
        "crypto"
       ],
       "type": "string",
       "default": "all"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "required": [
      "source",
      "as_of",
      "platform",
      "filter",
      "window",
      "communities",
      "page",
      "pages",
      "count",
      "results"
     ],
     "properties": {
      "page": {
       "type": "number"
      },
      "as_of": {
       "type": "string"
      },
      "count": {
       "type": "number"
      },
      "pages": {
       "type": "number"
      },
      "filter": {
       "enum": [
        "all",
        "stocks",
        "crypto"
       ],
       "type": "string"
      },
      "source": {
       "type": "string",
       "const": "x402stock"
      },
      "window": {
       "type": "string",
       "const": "24h"
      },
      "results": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "rank",
         "ticker",
         "name",
         "mentions",
         "upvotes",
         "rank_24h_ago",
         "mentions_24h_ago",
         "mentions_change",
         "mentions_change_percent",
         "rank_change"
        ],
        "properties": {
         "name": {
          "type": "string"
         },
         "rank": {
          "anyOf": [
           {
            "type": "number"
           },
           {
            "type": "null"
           }
          ]
         },
       
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "page": 1,
  "as_of": "2026-06-01T12:00:00.000Z",
  "count": 928,
  "pages": 10,
  "filter": "stocks",
  "source": "x402stock",
  "window": "24h",
  "results": [
   {
    "name": "NVIDIA",
    "rank": 1,
    "ticker": "NVDA",
    "upvotes": 2133,
    "mentions": 250,
    "rank_change": 3,
    "rank_24h_ago": 4,
    "mentions_change": 191,
    "mentions_24h_ago": 59,
    "mentions_change_percent": 323.7
   },
   {
    "name": "SPDR S&P 500 ETF Trust",
    "rank": 2,
    "ticker": "SPY",
    "upvotes": 915,
    "mentions": 231,
    "rank_change": 7,
    "rank_24h_ago": 9,
    "mentions_change": 186,
    "mentions_24h_ago": 45,
    "mentions_change_percent": 413.3
   }
  ],
  "platform": "reddit",
  "communities": [
   "r/wallstreetbets",
   "r/stocks",
   "r/options",
   "r/investing",
   "r/Daytrading",
   "r/SPACs",
   "r/WallStreetbetsELITE",
   "r/Wallstreetbetsnew"
  ]
 }
}
```

## More

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