# ApeWisdom Reddit Mentions API
> Live social-media buzz for stocks and crypto — how often each ticker is mentioned across Reddit's biggest trading communities (r/wallstreetbets, r/stocks, r/CryptoCurrency, r/options and more), powered by the public ApeWisdom feed, no key, nothing stored. This is the retail social-sentiment cut: not a price, but the attention a ticker is getting and whether that attention is rising or fading. The trending endpoint ranks tickers by current mention count for a chosen community filter, with each ticker's name, mentions, mentions 24 hours ago, today's rank, yesterday's rank and total Reddit upvotes. The gainers endpoint surfaces the tickers whose mentions surged the most versus yesterday — what is newly going viral before it moves. The filters endpoint lists the available communities, from all-stocks and all-crypto to individual subreddits. Track the meme-stock and meme-coin hype cycle as live JSON. This is the social-mention / meme-stock cut — distinct from the trader-post-stream (StockTwits), the price and the market-data APIs in the catalogue.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/apewisdom-api/..."
```

## Pricing
- **Free** (Free) — 24,000 calls/Mo, 3 req/s
- **Trader** ($8/Mo) — 260,000 calls/Mo, 10 req/s
- **Pro** ($22/Mo) — 1,050,000 calls/Mo, 28 req/s
- **Scale** ($52/Mo) — 3,500,000 calls/Mo, 60 req/s

## Endpoints

### Trending

#### `GET /v1/trending` — Tickers ranked by Reddit mentions

**Parameters:**
- `filter` (query, optional, string) — Community filter (see /v1/filters) Example: `all-stocks`
- `limit` (query, optional, string) — Results (1-100) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/apewisdom-api/v1/trending?filter=all-stocks&limit=50"
```

**Response:**
```json
{
    "data": {
        "count": 100,
        "total": 1197,
        "filter": "all-stocks",
        "source": "ApeWisdom",
        "tickers": [
            {
                "name": "Microsoft",
                "rank": 1,
                "ticker": "MSFT",
                "upvotes": 2187,
                "mentions": 554,
                "rank_change": 4,
                "rank_24h_ago": 5,
                "mention_change": 360,
                "mentions_24h_ago": 194
            },
            {
                "name": "SPDR S&P 500 ETF Trust",
                "rank": 2,
                "ticker": "SPY",
                "upvotes": 3745,
                "mentions": 543,
                "rank_change": -1,
                "rank_24h_ago": 1,
                "mention_change": -65,
                "mentions_24h_ago": 608
            },
            {
                "name": "Collaborative Investment Series Trust - The SPAC and New Issue ETF",
                "rank": 3,
                "ticker": "SPCX",
                "upvotes": 1777,
                "mentions": 426,
                "rank_change": 4,
                "rank_24h_ago": 7,
                "mention_change": 298,
                "mentions_24h_ago": 128
            },
            {
                "name": "Micron Technology",
                "rank": 4,
                "ticker": "MU",
                "upvotes": 1071,
                "mentions": 318,
                "rank_change": -1,
                "rank_24h_ago": 3,
        
…(truncated, see openapi.json for full schema)
```

### Gainers

#### `GET /v1/gainers` — Tickers with the biggest mention surge

**Parameters:**
- `filter` (query, optional, string) — Community filter (see /v1/filters) Example: `all-stocks`
- `limit` (query, optional, string) — Results (1-100) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/apewisdom-api/v1/gainers?filter=all-stocks&limit=50"
```

**Response:**
```json
{
    "data": {
        "note": "Tickers whose Reddit mentions rose the most vs 24h ago — newly going viral.",
        "count": 65,
        "filter": "all-stocks",
        "source": "ApeWisdom",
        "tickers": [
            {
                "name": "Microsoft",
                "rank": 1,
                "ticker": "MSFT",
                "upvotes": 2187,
                "mentions": 554,
                "rank_change": 4,
                "rank_24h_ago": 5,
                "mention_change": 360,
                "mentions_24h_ago": 194
            },
            {
                "name": "Collaborative Investment Series Trust - The SPAC and New Issue ETF",
                "rank": 3,
                "ticker": "SPCX",
                "upvotes": 1777,
                "mentions": 426,
                "rank_change": 4,
                "rank_24h_ago": 7,
                "mention_change": 298,
                "mentions_24h_ago": 128
            },
            {
                "name": "Adobe",
                "rank": 5,
                "ticker": "ADBE",
                "upvotes": 1132,
                "mentions": 234,
                "rank_change": 29,
                "rank_24h_ago": 34,
                "mention_change": 208,
                "mentions_24h_ago": 26
            },
            {
                "name": "Tesla",
                "rank": 9,
                "ticker": "TSLA",
                "upvotes": 501,
                "mentions": 132,
                "rank_change": 2
…(truncated, see openapi.json for full schema)
```

### Filters

#### `GET /v1/filters` — Available community filters

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/apewisdom-api/v1/filters"
```

**Response:**
```json
{
    "data": {
        "note": "Use any of these as the filter parameter on /v1/trending or /v1/gainers.",
        "count": 14,
        "source": "ApeWisdom",
        "filters": [
            "all",
            "all-stocks",
            "all-crypto",
            "wallstreetbets",
            "stocks",
            "stockmarket",
            "options",
            "cryptocurrency",
            "bitcoin",
            "satoshistreetbets",
            "spacs",
            "investing",
            "pennystocks",
            "4chan"
        ]
    },
    "meta": {
        "timestamp": "2026-06-12T01:43:05.644Z",
        "request_id": "62f2740e-4ea2-4590-9dd2-162ff7365089"
    },
    "status": "ok",
    "message": "Filters retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/apewisdom-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "filter selects the community (all-stocks default, all-crypto, wallstreetbets, cryptocurrency…). mention_change is mentions minus mentions-24h-ago; rank_change positive means the ticker is climbing.",
        "source": "ApeWisdom (apewisdom.io/api/v1.0, live, ~hourly)",
        "service": "apewisdom-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/filters": "Available community filters.",
            "GET /v1/gainers": "Tickers whose mentions surged most vs 24h ago (filter=all-stocks).",
            "GET /v1/trending": "Tickers ranked by current Reddit mentions (filter=all-stocks, limit=50)."
        },
        "description": "Live social-media buzz for stocks and crypto — how often each ticker is mentioned across Reddit's trading communities (r/wallstreetbets, r/stocks, r/CryptoCurrency and more), from ApeWisdom. The retail social-sentiment cut: not a price, but the attention a ticker gets and whether it is rising or fading. The trending endpoint ranks tickers by mention count for a community filter (name, mentions, mentions 24h ago, rank, rank change, upvotes); the gainers endpoint surfaces tickers whose mentions surged most vs yesterday; the filters endpoint lists the communities. Live, no key, nothing stored. The social-mention / meme-stock cut — distinct from the trader-post-stream (StockTwits), price and market-data APIs.",
        "tracked_stocks": 1197,
        "upstream_status": "ok"
…(truncated, see openapi.json for full schema)
```

### Sentiment

#### `GET /v1/losers` — Tickers with the biggest mention drop

**Parameters:**
- `filter` (query, optional, string) — Community filter (see /v1/filters) Example: `all-stocks`
- `limit` (query, optional, string) — Results (1-100) Example: `50`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/apewisdom-api/v1/losers?filter=all-stocks&limit=50"
```

**Response:**
```json
{
    "data": {
        "note": "Tickers whose Reddit mentions fell the most vs 24h ago — fading attention.",
        "count": 45,
        "filter": "all-stocks",
        "source": "ApeWisdom",
        "tickers": [
            {
                "name": "Microsoft",
                "rank": 4,
                "ticker": "MSFT",
                "upvotes": 1561,
                "mentions": 281,
                "rank_change": -3,
                "rank_24h_ago": 1,
                "mention_change": -305,
                "mentions_24h_ago": 586
            },
            {
                "name": "Adobe",
                "rank": 17,
                "ticker": "ADBE",
                "upvotes": 167,
                "mentions": 54,
                "rank_change": -12,
                "rank_24h_ago": 5,
                "mention_change": -192,
                "mentions_24h_ago": 246
            },
            {
                "name": "SPDR S&P 500 ETF Trust",
                "rank": 2,
                "ticker": "SPY",
                "upvotes": 2257,
                "mentions": 454,
                "rank_change": 1,
                "rank_24h_ago": 3,
                "mention_change": -94,
                "mentions_24h_ago": 548
            },
            {
                "name": "Invesco QQQ ETF",
                "rank": 10,
                "ticker": "QQQ",
                "upvotes": 333,
                "mentions": 139,
                "rank_change": -4,
                "rank_24h_ago"
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/ticker` — One ticker social-sentiment snapshot

**Parameters:**
- `ticker` (query, required, string) — Ticker symbol Example: `SPY`
- `filter` (query, optional, string) — Community filter (see /v1/filters) Example: `all-stocks`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/apewisdom-api/v1/ticker?ticker=SPY&filter=all-stocks"
```

**Response:**
```json
{
    "data": {
        "filter": "all-stocks",
        "source": "ApeWisdom",
        "ticker": {
            "name": "SPDR S&P 500 ETF Trust",
            "rank": 2,
            "ticker": "SPY",
            "upvotes": 2257,
            "mentions": 454,
            "rank_change": 1,
            "rank_24h_ago": 3,
            "mention_change": -94,
            "mentions_24h_ago": 548
        }
    },
    "meta": {
        "timestamp": "2026-06-13T13:55:38.407Z",
        "request_id": "0c462add-c8fe-4a16-accc-0357b4fab424"
    },
    "status": "ok",
    "message": "Ticker retrieved successfully",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/apewisdom-api
OpenAPI spec: https://www.oanor.com/api/apewisdom-api/openapi.json