# StockTwits Ticker Sentiment & Trending Symbol Feed (`dataspryva/stocktwits-ticker-sentiment-and-trending-symbol`) Actor

Reads StockTwits' public message stream for any ticker or user, the market-wide trending-symbols list with trend summaries, and ticker search, including each post's self-tagged sentiment.

- **URL**: https://apify.com/dataspryva/stocktwits-ticker-sentiment-and-trending-symbol.md
- **Developed by:** [Dataspryva](https://apify.com/dataspryva) (community)
- **Categories:** Social media, Automation, Developer tools
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## StockTwits Ticker Sentiment & Trending Symbol Feed

StockTwits is where retail traders post real-time, self-tagged Bullish/Bearish takes on stocks, ETFs, and crypto. This actor reads that public data for any ticker or trader: message streams, aggregate sentiment snapshots, daily sentiment history back to 2018, the full trending-symbols list with prices and fundamentals, current quotes, OHLCV price bars, search results, and reply threads — all without a login or API key.

### What this actor does

- **Nine modes:** ticker messages, trader posts, trending tickers, market-wide posts (trending / suggested / all), ticker sentiment, ticker overview, price history, search, and message threads.
- **Multi-target inputs:** up to 50 tickers or traders per run, with per-target record limits.
- **Sentiment:** per-message Bullish/Bearish tags plus StockTwits' own aggregate gauge and historical daily series.
- **Trending depth:** up to 573 trending instruments (not just the top 30), including price, fundamentals, and trend summaries where StockTwits provides them.
- **Deep archive:** v2 for recent filtered streams, automatic v3 continuation when the 12-month boundary is reached (AAPL back to 2009 in probes).
- **Filters:** newest/top/curated-trending sort, links/charts/videos, self-tagged sentiment, and message-ID bounds for incremental runs.
- **No credentials, no browser, no proxy setup.** Empty fields are omitted from each record.

### Output per record type

Every row has a `recordType` and `scrapedAt`.

#### Message (`recordType: "message"`)

- `messageId`, `body`, `createdAt`, `isDiscussion`, `sentiment` — post identity and the author's optional Bullish/Bearish tag
- `symbol`, `symbols`, `cashtags` — the ticker and every cashtag, with title, exchange, watchlist count, price, sentiment change, and volume change
- `priceAtPost`, `prices` — price snapshot(s) attached to the post
- `priceTarget`, `priceTargetDate`, `priceTargetDateTime`, `priceTargetStartingPrice`, `priceTargetCurrentPrice`, `priceTargetPercentChange` — StockTwits' source-reported price prediction, when the author attached one
- `priceTargetStatus`, `priceTargetSentiment`, `priceTargetType`, `priceTargetIsHit`, `priceTargetAccuracy` — prediction status and outcome metadata
- `priceTargetFinalPrice`, `priceTargetFinalPriceChange`, `priceTargetFinalPriceChangePercent`, `priceTargetCreatedAt`, `priceTargetSymbol` — final result and provenance
- `likeCount`, `reshareCount`, `replyCount` — engagement
- `isReply`, `isReshare`, `conversationParentMessageId`, `conversationInReplyToMessageId`, `isConversationParent`, `conversationRole` — thread context
- `userId`, `username`, `userDisplayName`, `userFollowers`, `userFollowing`, `userIdeas`, `userJoinDate`, `userOfficial`, `userIdentity`, `userClassification`, `userBadges`, `userHomeCountry`, `userLikeCount`, `userWatchlistCount`, `userTradeStatus` — author details
- `userAvatarUrl`, `userAvatarUrlOriginal`, `stocktwitsUserUrl`
- `mediaUrls`, `media`, `chartUrl`, `links`, `mentionedUsers`
- `resharedMessageId`, `resharedBody`, `resharedUsername`, `resharedCreatedAt`
- `source`, `sourceUrl`, `stocktwitsUrl`

#### Symbol (`recordType: "symbol"`)

- `symbol`, `symbolId`, `symbolDisplay`, `symbolMic`, `title`, `exchange`, `region`, `instrumentClass`, `logoUrl`, `watchlistCount`, `hasPricing`, `tradeStatus`, `liveEvent`, `aliases`, `cusip`, `isin`
- `sector`, `industry`, `rank`, `isTrending`, `trendingScore`, `trendSummary`, `trendSummaryAt`, `trendRanks`, `features`
- `priceLast`, `priceChange`, `pricePercentChange`, `priceOpen`, `priceHigh`, `priceLow`, `pricePreviousClose`, `priceVolume`, `priceCurrency`, `priceAsOf`, `extendedHoursPrice`, `extendedHoursChange`, `extendedHoursPercentChange`, `combinedPrice`, `combinedChange`, `combinedPercentChange`
- `marketCap`, `peRatio`, `eps`, `dividendRate`, `beta`, `sharesOutstanding`, `floatShares`, `revenue`, `grossMargin`, `totalCash`, `totalDebt`, `totalAssets`, `totalLiabilities`, `bookValuePerShare`, `priceToBook`, `revenuePerEmployee`, `revenueToAssets`, `avgDailyVolume1M`, `avgDailyVolume3M`, `high52Week`, `low52Week`, `fiftyDayMovingAverage`, `institutionalOwnership`, `earningsGrowth`, `employees`, `businessDescription`, `fiscalPeriodEnd`, `fundamentalsUpdatedAt`. Monetary fundamentals are in USD; share counts are share counts.
- `relatedSymbols` (when enabled), `matchedQuery` (search), `stocktwitsUrl`

#### Trader (`recordType: "user"`)

`userId`, `username`, `userDisplayName`, `userAvatarUrl`, `userAvatarUrlOriginal`, `userJoinDate`, `userOfficial`, `userIdentity`, `userClassification`, `userBadges`, `userHomeCountry`, `userFollowers`, `userFollowing`, `userIdeas`, `userWatchlistCount`, `userLikeCount`, `userTradeStatus`, optional `pinnedMessageId`/`pinnedMessageBody`/`pinnedMessageCreatedAt`, `stocktwitsUrl`, and search-only `premium`, `verified`, `companyRepresentative`, `matchedQuery`.

#### Sentiment snapshot (`recordType: "sentiment"`)

One row per ticker with a `timeframes` object keyed `15m`, `24h`, `now`, `1D`, `1W`, `1M`, `3M`, `6M`, `1Y`, and `ALL`. Each timeframe carries:

- `sentimentValue`, `sentimentLabel`, `sentimentScore`, `sentimentScoreLabel`, `sentimentChange`
- `messageVolume`, `messageVolumeLabel`, `messageVolumeScore`, `messageVolumeScoreLabel`, `messageVolumeChange`
- `participationRatio`, `participationLabel`, `participationScore`, `participationScoreLabel`, `participationChange` where available

#### Sentiment history (`recordType: "sentimentPoint"`)

One row per date/time: `symbol`, `dateTime`, `sentimentValue`, `sentimentLabel`, `sentimentScore`, `sentimentScoreLabel`, `messageVolume`, `messageVolumeLabel`, `messageVolumeScore`, `messageVolumeScoreLabel`, `participationRatio`, `participationLabel`, `participationScore`, `participationScoreLabel`.

#### Price bar (`recordType: "priceBar"`)

`symbol`, `date`, `startTime`, `endTime`, `dateTime`, `open`, `high`, `low`, `close`, `last`, `volume`, `trades`, `vwap`, `twap`, `utcOffset`.

### Input

| Field | Type | Default | Description |
| --- | --- | --- | --- |
| `mode` | string (select) | `symbolMessages` | `symbolMessages`, `userMessages`, `trendingSymbols`, `marketMessages`, `symbolSentiment`, `symbolOverview`, `priceHistory`, `search`, `conversation`. Legacy aliases `trendingMessages` and `symbolSearch` are still accepted. |
| `symbols` | array | `["AAPL"]` | Tickers for symbol modes. Accepts `AAPL`, `$TSLA`, `BTC.X`, `BRK.B`, `SHOP.TSX`, or symbol URLs. |
| `usernames` | array | – | Traders for `userMessages`, without `@`; profile URLs accepted. |
| `searchQueries` | array | – | Names or tickers for `search`. |
| `searchType` | string (select) | `all` | `all`, `symbols`, or `users`. |
| `streamFilter` | string (select) | `all` | `all` (newest), `top` (ranked), `trending` (curated top 100 per ticker). |
| `contentFilter` | string (select) | `all` | `all`, `links`, `charts`, `videos`. |
| `sentimentFilter` | string (select) | `any` | `any`, `bullish`, `bearish`, `tagged`. |
| `onlyPriceTargets` | boolean | `false` | Keep only messages with a source-reported price prediction. |
| `feedType` | string (select) | `trending` | `trending`, `suggested`, or `all` (public market-wide chronological stream). |
| `trendingAssetClass` | string (select) | `all` | `all`, `stocks`, `etf`, `crypto`, `adr`, `commodity`. |
| `sentimentRange` | string (select) | `now` | `now`, `1D`, `1W`, `1M`, `3M`, `6M`, `1Y`, `5Y`, `ALL`. |
| `chartZoom` | string (select) | `1M` | `1D`, `1W`, `1M`, `3M`, `6M`, `YTD`, `1Y`, `5Y`, `ALL`. |
| `includeUserProfile` | boolean | `false` | Add a trader profile record in `userMessages`. |
| `includeRelatedSymbols` | boolean | `false` | Add related tickers in `symbolOverview`. |
| `newerThanMessageId` | integer | – | Keep messages newer than this StockTwits message ID. |
| `olderThanMessageId` | integer | – | Start at or below this message ID and page further back. |
| `messageIds` | array | – | Message IDs or URLs for `conversation`. |
| `maxItems` | integer | `30` | Per ticker/trader/query/thread for target modes; total for feeds; max points/bars for history modes. 1–5000. |

#### Example: latest tagged sentiment on several tickers

```json
{
  "mode": "symbolMessages",
  "symbols": ["AAPL", "TSLA", "NVDA"],
  "streamFilter": "all",
  "sentimentFilter": "tagged",
  "maxItems": 50
}
```

#### Example: daily sentiment history for a watchlist

```json
{
  "mode": "symbolSentiment",
  "symbols": ["AAPL", "MSFT", "SPY", "BTC.X"],
  "sentimentRange": "ALL",
  "maxItems": 500
}
```

#### Example: trending crypto with prices and fundamentals

```json
{
  "mode": "trendingSymbols",
  "trendingAssetClass": "crypto",
  "maxItems": 74
}
```

#### Example: quote, fundamentals, and related tickers

```json
{
  "mode": "symbolOverview",
  "symbols": ["NVDA", "AMD", "ASML"],
  "includeRelatedSymbols": true,
  "maxItems": 3
}
```

#### Example: a trader's posts plus their profile

```json
{
  "mode": "userMessages",
  "usernames": ["KirRoyalTrader"],
  "includeUserProfile": true,
  "maxItems": 100
}
```

#### Example: a message thread

```json
{
  "mode": "conversation",
  "messageIds": ["https://stocktwits.com/TalkMarkets/message/666869978"],
  "maxItems": 30
}
```

### Use cases

- **Sentiment research** — compare self-tagged Bullish/Bearish posts with StockTwits' aggregate gauge and daily history.
- **Trading dashboards** — feed message volume, participation, sentiment scores, and trending ranks into a live dashboard.
- **Scheduled monitoring** — use `newerThanMessageId` to collect only posts published since the last run.
- **Trend discovery** — scan the full trending list, filter to stocks, ETFs, or crypto, and read StockTwits' why-it-is-trending summaries.
- **Trader research** — export a public trader's post history, profile stats, and replies for influence analysis.
- **Quant datasets** — join ticker messages, quotes, fundamentals, and OHLCV bars in one run for model training or backtesting.

### FAQ

**Does this need a StockTwits login or API key?**
No. It reads the same public JSON endpoints the StockTwits website uses when you browse logged out. No cookies, API key, or proxy setup is required.

**How far back do messages go?**
Recent filtered streams use StockTwits' 12-month v2 window. When that walk reaches the boundary, the actor continues through StockTwits' v3 stream API: probes reached 2009 for AAPL and 2022 across 38/38 diverse tickers, with user archives varying by account. `streamFilter=top` stays on the recent ranked window; the archive continuation is chronological. Older v3 rows can omit fields the current source no longer serializes (for example `links` or reply context). Sentiment history goes back to 2018, and price bars go back to 2016 where the ticker has data.

**Why is `sentiment` missing from many messages?**
Tagging a post Bullish or Bearish is optional. Untagged posts simply omit the field. Use `sentimentFilter=tagged`, or use the `symbolSentiment` mode for StockTwits' aggregate gauge, which is not limited to tagged posts.

**What do `sentimentScore` and `sentimentScoreLabel` mean?**
They are StockTwits' normalized 0–100 score and label (for example "Extremely Bearish"). `sentimentValue` is the underlying raw value, which can be negative. The normalized pair is what the StockTwits website displays. Snapshot mode returns one row per ticker with a `timeframes` object containing all ten timeframes; history mode returns one row per date/time.

**Why are some trending tickers missing prices or fundamentals?**
StockTwits publishes richer data for equities than for some ETFs and crypto. AI trend summaries are generated by StockTwits only for the top of the trending list, not for every symbol. Fields the source does not provide are omitted rather than filled with placeholder values.

**Does every ticker have price history?**
Most US, Canadian, ETF, and crypto symbols do. A few valid message-stream symbols — often very thinly traded or foreign listings such as some `.TSX` names — have no chart data; the actor skips them and continues, while `symbolOverview` can still return their quote.

**Can I get more than 30 trending tickers?**
Yes. The trending mode walks StockTwits' enhanced list, which currently returns up to about 573 instruments (about 74 for crypto). `marketMessages` with `feedType=all` reads the public market-wide stream instead. Search is separate and capped by StockTwits at 12 symbol or 15 user results per query.

**Can I collect messages for a specific trader and ticker together?**
StockTwits' combined user+ticker endpoint requires authentication, so it is not used. You can fetch a trader's posts and filter the `cashtags`/`symbols` fields client-side.

**Why do links to stocktwits.com sometimes fail in scripts?**
StockTwits protects its website pages with a browser challenge. The links are valid and open normally in a browser; this affects page navigation, not the actor's data.

**Does the actor invent price targets or text sentiment?**
No. It returns StockTwits' own source-reported price predictions when an author attached one (`priceTarget*` fields) and never generates targets or model-based text sentiment. Empty fields are omitted rather than returned as `null`.

# Actor input Schema

## `mode` (type: `string`):

What to fetch from StockTwits.

## `symbols` (type: `array`):

Tickers to fetch, e.g. AAPL, TSLA, BTC.X, BRK.B, SHOP.TSX. Accepts $cashtags and StockTwits symbol URLs. Use .X for crypto.

## `usernames` (type: `array`):

StockTwits usernames without @, or profile URLs, e.g. KirRoyalTrader, https://stocktwits.com/Fibonaccino.

## `searchQueries` (type: `array`):

Company names, tickers, or trader names to search for, e.g. tesla, apple, TraderLion.

## `searchType` (type: `string`):

What to return from each query.

## `streamFilter` (type: `string`):

All = newest first, Top = StockTwits ranking, Trending = curated high-engagement posts for the ticker (up to 100).

## `contentFilter` (type: `string`):

Keep only messages with this attachment. Videos are rare; All keeps every message.

## `sentimentFilter` (type: `string`):

Keep posts by the author's self-tagged sentiment. Most posts are untagged; Any keeps all.

## `onlyPriceTargets` (type: `boolean`):

Keep only messages where the author attached a StockTwits price prediction (price target).

## `feedType` (type: `string`):

Trending = market-wide trending posts; Suggested = posts from StockTwits' curated suggested traders; All = public market-wide firehose (deep, chronological).

## `trendingAssetClass` (type: `string`):

Which trending instruments to keep. All includes stocks, ETFs, crypto, ADRs, commodities, and other classes.

## `sentimentRange` (type: `string`):

Now = current sentiment across 15m, 24h, now, 1D–ALL. Other values return the daily/intraday history for that window.

## `chartZoom` (type: `string`):

Intraday windows use 5-minute (1D) or 30-minute (1W) bars; other windows use daily/weekly bars.

## `includeUserProfile` (type: `boolean`):

Add one profile record per username before that trader's posts.

## `includeRelatedSymbols` (type: `boolean`):

Add StockTwits' related-industry tickers to each symbol record.

## `newerThanMessageId` (type: `integer`):

Only keep messages with an ID greater than this. Useful for incremental scheduled runs.

## `olderThanMessageId` (type: `integer`):

Start from messages at or below this ID and page further back.

## `messageIds` (type: `array`):

Message IDs or StockTwits message URLs whose parent + reply thread should be fetched.

## `maxItems` (type: `integer`):

Per ticker/username/query/thread for target modes; total for trending and market feeds; max points or bars for history modes.

## Actor input object example

```json
{
  "mode": "symbolMessages",
  "symbols": [
    "AAPL"
  ],
  "usernames": [],
  "searchQueries": [],
  "searchType": "all",
  "streamFilter": "all",
  "contentFilter": "all",
  "sentimentFilter": "any",
  "onlyPriceTargets": false,
  "feedType": "trending",
  "trendingAssetClass": "all",
  "sentimentRange": "now",
  "chartZoom": "1M",
  "includeUserProfile": false,
  "includeRelatedSymbols": false,
  "messageIds": [],
  "maxItems": 3
}
```

# Actor output Schema

## `records` (type: `string`):

Dataset containing all scraped StockTwits records, keyed by recordType.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "symbolMessages",
    "symbols": [
        "AAPL"
    ],
    "streamFilter": "all",
    "contentFilter": "all",
    "sentimentFilter": "any",
    "onlyPriceTargets": false,
    "includeUserProfile": false,
    "includeRelatedSymbols": false,
    "maxItems": 3
};

// Run the Actor and wait for it to finish
const run = await client.actor("dataspryva/stocktwits-ticker-sentiment-and-trending-symbol").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "symbolMessages",
    "symbols": ["AAPL"],
    "streamFilter": "all",
    "contentFilter": "all",
    "sentimentFilter": "any",
    "onlyPriceTargets": False,
    "includeUserProfile": False,
    "includeRelatedSymbols": False,
    "maxItems": 3,
}

# Run the Actor and wait for it to finish
run = client.actor("dataspryva/stocktwits-ticker-sentiment-and-trending-symbol").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "symbolMessages",
  "symbols": [
    "AAPL"
  ],
  "streamFilter": "all",
  "contentFilter": "all",
  "sentimentFilter": "any",
  "onlyPriceTargets": false,
  "includeUserProfile": false,
  "includeRelatedSymbols": false,
  "maxItems": 3
}' |
apify call dataspryva/stocktwits-ticker-sentiment-and-trending-symbol --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dataspryva/stocktwits-ticker-sentiment-and-trending-symbol"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/gO7zdvF0aSw7rDweu/builds/e7mFmdFkY1PvZoBtw/openapi.json