# 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 Example: `all-stocks`
- `limit` (query, optional, string) — Max tickers (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"
```

### Gainers

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

**Parameters:**
- `filter` (query, optional, string) — Community filter Example: `all-stocks`
- `limit` (query, optional, string) — Max tickers (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"
```

### Filters

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

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

### Meta

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

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


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