Stocktwits APIstocktwits.com ↗
Get currently trending stock and crypto symbols from Stocktwits — with ticker, price, volume, trending scores, and market index data. Paginated, filterable by asset class.
What is the Stocktwits API?
The Stocktwits Trending Symbols API exposes one endpoint — get_trending_symbols — that returns up to 30 trending tickers per page, each with fields including trending_score, instrument_class, sector, industry, watchlist count, and current price data. It also includes a market_indexes array with ETF-level price and volume snapshots, giving a quick read on broader market context alongside community momentum signals.
curl -X GET 'https://api.parse.bot/scraper/09e16524-4533-449c-b713-8f1299802060/get_trending_symbols?page=1&class=all&limit=10®ion=US' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace stocktwits-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Stocktwits trending symbols — discover what's moving the market."""
from parse_apis.stocktwits_trending_symbols_api import Stocktwits, AssetClass, Region, UpstreamError
client = Stocktwits()
# List top trending US equities, capped at 5 items
for symbol in client.trendingsymbols.list(asset_class=AssetClass.ALL, region=Region.US, limit=5):
print(symbol.symbol, symbol.title, symbol.trending_score, symbol.percent_change)
# Drill into the first trending crypto symbol
crypto = client.trendingsymbols.list(asset_class=AssetClass.CRYPTO, region=Region.X, limit=1).first()
if crypto:
print(crypto.symbol, crypto.title, crypto.price, crypto.volume)
# Handle upstream errors gracefully
try:
for s in client.trendingsymbols.list(region=Region.CA, limit=3):
print(s.symbol, s.rank, s.trend_summary)
except UpstreamError as exc:
print(f"upstream issue: {exc}")
print("exercised: trendingsymbols.list with AssetClass/Region enums, error handling")
Get the list of currently trending stock ticker symbols on Stocktwits, including company names, trending scores, price data, volume, and community trend summaries. Results are paginated with up to 30 symbols per page. Each symbol includes real-time pricing, sector classification, watchlist counts, and an AI-generated trend summary describing why the symbol is trending.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| class | string | Asset class filter. |
| limit | integer | Number of trending symbols to return per page (max 30). |
| region | string | Region filter. |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"has_more": "boolean, whether more pages are available",
"market_indexes": "array of market index ETF objects with symbol, title, exchange, price, change, percent_change, and volume",
"total_returned": "integer, number of symbols returned on this page",
"trending_symbols": "array of trending symbol objects with rank, symbol, title, exchange, sector, industry, instrument_class, trending_score, watchlist_count, logo_url, trend_summary, trend_rank_all, trend_rank_region, price, change, percent_change, and volume"
},
"sample": {
"data": {
"page": 1,
"has_more": true,
"market_indexes": [
{
"price": 741.44,
"title": "SPDR S&P 500 ETF Trust",
"change": -6.73,
"symbol": "SPY",
"volume": 10355142,
"exchange": "NYSEArca",
"percent_change": -0.9
}
],
"total_returned": 30,
"trending_symbols": [
{
"rank": 1,
"price": 23.66,
"title": "Figma",
"change": 3.42,
"sector": "TechnologyServices",
"symbol": "FIG",
"volume": 30357600,
"exchange": "NYSE",
"industry": "PackagedSoftware",
"logo_url": "https://logos.stocktwits-cdn.com/FIG.png",
"trend_summary": "Figma is trending following a strong quarterly earnings report...",
"percent_change": 16.9,
"trend_rank_all": 1,
"trending_score": 19.78,
"watchlist_count": 16052,
"instrument_class": "Stock",
"trend_rank_region": 1
}
]
},
"status": "success"
}
}About the Stocktwits API
What the API Returns
The get_trending_symbols endpoint returns a paginated list of tickers currently trending on Stocktwits. Each entry in the trending_symbols array includes the ticker symbol, company title, exchange, sector, industry, instrument_class, trending_score, and watchlist count. The trending_score is a numeric signal reflecting the relative volume of discussion for that symbol at the time of the request.
Filtering and Pagination
Results can be filtered using the class parameter, which accepts all, equity, or crypto. The region parameter narrows results to US, CA, or X (crypto). Use the limit parameter to request fewer than the maximum 30 results per page, and the page parameter to step through additional pages. The has_more boolean in the response indicates whether further pages exist.
Market Index Context
Alongside trending symbols, the response includes a market_indexes array. Each entry contains a market index ETF with its symbol, title, exchange, price, change, percent_change, and volume. This lets you cross-reference community trending activity against broad market movement without making a separate request.
Coverage Notes
The API covers equities listed on US and Canadian exchanges, as well as crypto assets. Sector and industry classifications are returned where available, but may be absent for certain instruments — particularly crypto assets, which often omit sector and industry fields. The watchlist field reflects community tracking counts on Stocktwits specifically and does not represent order flow or brokerage activity.
The Stocktwits API is a managed, monitored endpoint for stocktwits.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when stocktwits.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official stocktwits.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track which tickers are surging in social discussion before or after market open using
trending_score - Filter trending crypto assets separately from equities using the
class=cryptoparameter - Compare community momentum signals against market index ETF moves using the
market_indexesresponse field - Build a sector-level heat map of retail investor interest by aggregating
sectorandindustryfields - Monitor
watchlistcounts over time to detect growing retail attention in specific tickers - Scope trending activity to Canadian-listed securities using the
region=CAfilter - Page through full trending lists programmatically using the
pageandhas_morefields
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Stocktwits have an official developer API?+
What does the `trending_score` field represent?+
trending_score is a numeric value that reflects how actively a symbol is being discussed on Stocktwits relative to its baseline activity. It is not a sentiment polarity score — it measures discussion volume or velocity, not whether sentiment is bullish or bearish.Does the API return individual Stocktwits posts or sentiment breakdowns for each trending symbol?+
trending_score and watchlist counts, but does not return individual messages, bullish/bearish vote splits, or per-symbol sentiment percentages. You can fork this API on Parse and revise it to add an endpoint that fetches symbol-level message streams or sentiment data.Are all 30 trending symbols always returned in a single response?+
limit parameter controls how many symbols are returned per page, up to a maximum of 30. The total_returned field in the response confirms the actual count. If more results exist beyond the current page, has_more will be true and you can increment the page parameter to retrieve them.