# StockTwits Social API > Live data from StockTwits, the social network for traders and investors where every post is tagged with the stock and crypto tickers ("cashtags") it is about and an optional Bullish or Bearish sentiment — served from the public StockTwits feed, no key, nothing stored. The symbol endpoint returns a ticker's live message stream — the latest posts about $AAPL, $TSLA, $BTC.X or any symbol — each with its author and sentiment, plus the symbol's title and how many users watch it. The trending endpoint returns the tickers traders are talking about most right now, the social pulse of the market. The user endpoint returns a member's profile — followers, following, ideas posted and likes — and their recent posts. Read retail trader sentiment, find what is buzzing and track any investor's feed as live JSON. This is the trader-social-network cut — distinct from the price, market-data and FX-signal 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/stocktwits-api/..." ``` ## Pricing - **Free** (Free) — 23,000 calls/Mo, 3 req/s - **Trader** ($7/Mo) — 255,000 calls/Mo, 10 req/s - **Pro** ($22/Mo) — 1,000,000 calls/Mo, 28 req/s - **Scale** ($51/Mo) — 3,400,000 calls/Mo, 60 req/s ## Endpoints ### Symbol #### `GET /v1/symbol` — A ticker live message stream with sentiment **Parameters:** - `symbol` (query, required, string) — Cashtag without the $ (stock or crypto) Example: `AAPL` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/stocktwits-api/v1/symbol?symbol=AAPL" ``` **Response:** ```json { "data": { "title": "Apple Inc", "source": "StockTwits", "symbol": "AAPL", "exchange": "NASDAQ", "messages": [ { "id": 656149730, "body": "$AAPL $AAPL trading it from the \n#golf #course in our back yard. \n \n#Man_o_War 7th tee box. \n \n#Myrtle #Beach \n \nIf you're in town, we can meet up, I'll buy the beers!", "name": "Vinny Gambini Tracy LeBlanc", "likes": null, "symbols": [ "AAPL" ], "username": "Cousin_Vinny", "sentiment": "Bullish", "created_at": "2026-06-11T16:43:39Z" }, { "id": 656148974, "body": "$AAPL 👍", "name": "RInvest41", "likes": null, "symbols": [ "AAPL" ], "username": "RInvest41", "sentiment": "Bullish", "created_at": "2026-06-11T16:38:04Z" }, { "id": 656148603, "body": "$AAPL Wall Street crackheads addition lol $$$$$$$$$$$$$$$$$$", "name": "Russ", "likes": null, "symbols": [ "AAPL" ], "username": "prstrader", "sentiment": null, "created_at": "2026-06-11T16: …(truncated, see openapi.json for full schema) ``` ### Trending #### `GET /v1/trending` — Tickers being discussed most right now **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/stocktwits-api/v1/trending" ``` **Response:** ```json { "data": { "note": "Tickers being discussed the most on StockTwits right now.", "count": 30, "source": "StockTwits", "symbols": [ { "title": "Adobe Inc", "symbol": "ADBE", "exchange": "NASDAQ", "watchlist_count": 48782 }, { "title": "Trade Desk Inc", "symbol": "TTD", "exchange": "NASDAQ", "watchlist_count": 48184 }, { "title": "Velo3D Inc", "symbol": "VELO", "exchange": "NASDAQ", "watchlist_count": 8243 }, { "title": "Oracle Corp.", "symbol": "ORCL", "exchange": "NYSE", "watchlist_count": 63631 }, { "title": "EchoStar Corp", "symbol": "SATS", "exchange": "NASDAQ", "watchlist_count": 5204 }, { "title": "Alphabet Inc - Ordinary Shares - Class C", "symbol": "GOOG", "exchange": "NASDAQ", "watchlist_count": 308844 }, { "title": "Microsoft Corp", "symbol": "MSFT", "exchange": "NASDAQ", "watchlist_count": 535297 }, { …(truncated, see openapi.json for full schema) ``` ### User #### `GET /v1/user` — A member profile and recent posts **Parameters:** - `username` (query, required, string) — StockTwits username Example: `Stocktwits` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/stocktwits-api/v1/user?username=Stocktwits" ``` **Response:** ```json { "data": { "bio": null, "name": "Stocktwits", "ideas": 134708, "source": "StockTwits", "location": null, "messages": [ { "id": 656148534, "body": "@androsForm epic...", "name": "Stocktwits", "likes": null, "symbols": [], "username": "Stocktwits", "sentiment": null, "created_at": "2026-06-11T16:35:10Z" }, { "id": 656145136, "body": "$ADBE earnings after the close today - any buyers out there or could this get under $200?", "name": "Stocktwits", "likes": null, "symbols": [ "ADBE" ], "username": "Stocktwits", "sentiment": null, "created_at": "2026-06-11T16:11:07Z" }, { "id": 656140304, "body": "@Mjohns92 used $SLS gains for a down payment on a house - amazing story", "name": "Stocktwits", "likes": null, "symbols": [ "SLS" ], "username": "Stocktwits", "sentiment": null, "created_at": "2026-06-11T15:40:16Z" }, { "id": 656139578, "body": "$ORCL now down over 10% - who …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/stocktwits-api/v1/meta" ``` **Response:** ```json { "data": { "note": "symbol is a cashtag without the $ (AAPL, TSLA, BTC.X). username is a StockTwits handle. Each post may carry a Bullish/Bearish sentiment where the author set one. Streams are cached briefly to respect StockTwits' rate limit.", "source": "StockTwits API v2 (api.stocktwits.com/api/2, live)", "service": "stocktwits-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/user": "A member's profile and recent posts (username=Stocktwits).", "GET /v1/symbol": "A ticker's live message stream with sentiment, plus title and watcher count (symbol=AAPL).", "GET /v1/trending": "Tickers being discussed most on StockTwits right now." }, "description": "Live data from StockTwits, the social network for traders and investors where every post is tagged with the stock and crypto tickers (cashtags) it is about and an optional Bullish/Bearish sentiment. The symbol endpoint returns a ticker's live message stream plus its title and watcher count; the trending endpoint returns the tickers being discussed most right now; the user endpoint returns a member's profile (followers, following, ideas, likes) and recent posts. Live, no key, nothing stored. The trader-social-network cut — distinct from the price, market-data and FX-signal APIs.", "upstream_status": "ok" }, "meta": { "timestamp": "2026-06-11T16:46:39.716Z", "request_id": "9a5875f5-9ab …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/stocktwits-api OpenAPI spec: https://www.oanor.com/api/stocktwits-api/openapi.json