--- title: "Raw mentions" method: GET path: "/polymarket/stocks/v1/stock/{ticker}/mentions" tags: ["Polymarket Stocks"] --- # Raw mentions `GET /polymarket/stocks/v1/stock/{ticker}/mentions` ## Request - Base URL: `https://api.adanos.com` - URL: `https://api.adanos.com/polymarket/stocks/v1/stock/{ticker}/mentions` - Auth: API key in header `X-API-Key` Returns raw Polymarket market snapshot rows for a specific ticker within the live raw-data retention window. **Professional account required.** Free and Hobby accounts cannot use this endpoint. **Use this endpoint when you need:** - original market questions, prices, liquidity, volume, trade counters and timestamps - outcome-aware market price sentiment for individual snapshot rows - repeated snapshots for the same market over time **Notes:** - Use `from` and `to` for explicit UTC date windows - Results are ordered newest first and support deterministic `offset` + `limit` pagination - Graph keys with no rows return `200` with `results=[]` - keys that are not Graph keys return `404`, regardless of the requested window or offset; `503` when the key lookup is unavailable - The same `condition_id` can appear multiple times across different `fetched_at` snapshots - `active` indicates whether the market is currently open, using the latest stored state for that `condition_id`; `market_status` compactly distinguishes `tradable`, `open`, `resolved`, `expired` and `inactive` - `buy_trades` and `sell_trades` are activity counters, not bullish/bearish sentiment ## Path parameters - `ticker` string, required: Instrument Graph key, case-insensitive: the company key for a stock (AAPL, BNY, BRK, SKHY), the product key for an ETF (SPY, EWG). 1-32 ASCII letters/digits with an optional documented venue suffix (SAP.DE). Share classes (BRK.A, BRK-B), cashtags and unknown suffixes return 422; other keys that are not Graph keys return 404. Listing aliases and keys used before the Graph switch are not accepted; use `/search` to find a company's key. ## Query parameters - `from` string, date, nullable: Start date in YYYY-MM-DD. Inclusive UTC date. - `to` string, date, nullable: End date in YYYY-MM-DD. Inclusive UTC date. Omit to use the current UTC date. - `limit` integer: Maximum number of raw Polymarket snapshot rows to return - `offset` integer: Number of raw mention rows to skip for offset-based pagination. ## Response `200` Successful Response - PolymarketRawMentionsResponse: Paginated raw Polymarket snapshot rows for a single stock ticker. - `ticker` string, required: Instrument Graph key: the company key for a stock (AAPL, BNY), the product key for an ETF (EWG) - `period_days` integer, required: Lookback window used for the query - `count` integer, required: Total number of matching raw rows before limit and offset are applied; only the requested page is returned - `results` PolymarketRawMentionItem[], required: Raw market snapshot rows ordered by newest first - `condition_id` string, required: Polymarket condition ID - `event_id` string, required: Polymarket event ID - `market_slug` string, nullable: Polymarket market slug - `question` string, required: Market question/title - `market_type` string, required: Derived market type (`up_down`, `close_above`, `hit_target`, `earnings` or `other`) - `strike_price` number, nullable: Extracted strike price when available - `yes_price` number, nullable: YES price from this snapshot - `no_price` number, nullable: NO price from this snapshot - `reference_price` number, nullable: Stock reference price attached during scrape when needed for range-ladder classification - `reference_price_timestamp` string, date-time, nullable: Timestamp for `reference_price` when available - `liquidity` number, required: Market liquidity in USD at snapshot time - `volume_24h` number, required: Rolling 24h market volume in USD at snapshot time - `trade_count` integer, required: UTC-day trade count observed for this market snapshot - `buy_trades` integer, required: UTC-day Polymarket BUY trades for this snapshot; activity counter, not bullishness - `sell_trades` integer, required: UTC-day Polymarket SELL trades for this snapshot; activity counter, not bearishness - `unique_traders` integer, required: UTC-day observed participant/proxy-wallet counter for this market snapshot - `sentiment_score` number, nullable: Outcome-aware market price sentiment for this snapshot; prefers orderbook midpoint when available, falls back to YES/NO price and is null when direction or evidence is unavailable - `sentiment_label` 'positive' | 'negative' | 'neutral', nullable: Classification derived from `sentiment_score`: positive=bullish, negative=bearish, neutral=flat; null when `sentiment_score` is null - `end_date` string, date-time, nullable: Market end timestamp when available. Unlike summary `top_mentions`, raw rows preserve the full timestamp from the stored snapshot. - `active` boolean, required: Whether the market is currently open; false for closed or ended markets - `market_status` 'tradable' | 'open' | 'resolved' | 'inactive' | 'expired', required: Compact current market status derived from active, closed, accepting_orders and end_date - `fetched_at` string, date-time, required: Snapshot fetch timestamp ## Other responses - `401`: Authentication failed - `403`: Historical data limit exceeded - `404`: Unsupported ticker - `422`: Invalid period or query parameters - `429`: Rate limit exceeded - `503`: Instrument Graph key lookup or database service unavailable; no legacy fallback is used - `504`: Analytics request deadline exceeded ## Changes - **2026-11-04** `7e8bdb1e7e75`: 1 warning, 1 info - changed the pattern of the `path` request parameter `ticker` from `^\$?(?:[A-Za-z0-9]{1,8}[.-][A-Za-z]|[A-Za-z0-9]{0}[A-Za-z][A-Za-z0-9]{0,9}|[A-Za-z0-9]{1}[A-Za-z][A-Za-z0-9]{0,8}|[A-Za-z0-9]{2}[A-Za-z][A-Za-z0-9]{0,7}|[A-Za-z0-9]{3}[A-Za-z][A-Za-z0-9]{0,6}|[A-Za-z0-9]{4}[A-Za-z][A-Za-z0-9]{0,5}|[A-Za-z0-9]{5}[A-Za-z][A-Za-z0-9]{0,4}|[A-Za-z0-9]{6}[A-Za-z][A-Za-z0-9]{0,3}|[A-Za-z0-9]{7}[A-Za-z][A-Za-z0-9]{0,2}|[A-Za-z0-9]{8}[A-Za-z][A-Za-z0-9]{0,1}|[A-Za-z0-9]{9}[A-Za-z][A-Za-z0-9]{0,0}|[0-9]{3,10})$` to `^(?=[A-Za-z0-9.]{1,32}$)[A-Za-z0-9]+(?:\.(?:[Aa][Ee]|[Aa][Ss]|[Aa][Tt]|[Aa][Xx]|[Bb][Aa]|[Bb][Dd]|[Bb][Kk]|[Bb][Oo]|[Bb][Rr]|[Cc][Aa]|[Cc][Ll]|[Cc][Nn]|[Cc][Oo]|[Dd][Ee]|[Dd][Uu]|[Ff]|[Hh][Aa]|[Hh][Ee]|[Hh][Kk]|[Hh][Mm]|[Ii][Cc]|[Ii][Rr]|[Ii][Ss]|[Jj][Kk]|[Jj][Oo]|[Kk][Ll]|[Kk][Qq]|[Kk][Ss]|[Kk][Ww]|[Ll]|[Ll][Ss]|[Mm][Cc]|[Mm][Ii]|[Mm][Uu]|[Mm][Xx]|[Nn][Ee]|[Nn][Ss]|[Nn][Zz]|[Oo][Ll]|[Pp][Aa]|[Pp][Rr]|[Pp][Ss]|[Qq][Aa]|[Rr][Oo]|[Ss][Aa]|[Ss][Aa][Uu]|[Ss][Gg]|[Ss][Ii]|[Ss][Nn]|[Ss][Ss]|[Ss][Tt]|[Ss][Ww]|[Ss][Zz]|[Tt]|[Tt][Aa]|[Tt][Oo]|[Tt][Ww]|[Tt][Ww][Oo]|[Vv]|[Vv][Ii]|[Vv][Nn]|[Ww][Aa]))?$(?![\s\S])` - added the non-success response with the status `404` - **2026-09-30** `a74a23b969c4`: 1 info - deleted the `query` request parameter `days` with deprecation [Operation history](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/changes/polymarket/stocks/v1/stock/:ticker/mentions/get.md) --- [API](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api.md) - [All operations](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/revisions/7e8bdb1e7e75?raw)