ADadanos
Polymarket Stocks

Raw mentions

Changed on

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
get/polymarket/stocks/v1/stock/{ticker}/mentions

Request

  • Base URL
    https://api.adanos.com
  • Auth
    API key in header X-API-Key

Path parameters

tickerstring 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.

Example:TSLA

Query parameters

fromstring date nullable

Start date in YYYY-MM-DD. Inclusive UTC date.

tostring date nullable

End date in YYYY-MM-DD. Inclusive UTC date. Omit to use the current UTC date.

limitinteger

Maximum number of raw Polymarket snapshot rows to return

Example:50
offsetinteger

Number of raw mention rows to skip for offset-based pagination.

Response

Successful Response

tickerstring required

Instrument Graph key: the company key for a stock (AAPL, BNY), the product key for an ETF (EWG)

period_daysinteger required

Lookback window used for the query

countinteger required

Total number of matching raw rows before limit and offset are applied; only the requested page is returned

Example response

{
  "ticker": "NVDA",
  "period_days": 7,
  "count": 1,
  "results": [
    {
      "condition_id": "0xabc...",
      "event_id": "12345",
      "market_slug": "nvda-up-or-down-on-april-20-2026",
      "question": "NVDA up or down on April 20?",
      "market_type": "up_down",
      "strike_price": 250,
      "yes_price": 0.63,
      "no_price": 0.37,
      "reference_price": 247.82,
      "reference_price_timestamp": "2026-04-20T14:30:00Z",
      "liquidity": 7905.52,
      "volume_24h": 2408.43,
      "trade_count": 42,
      "buy_trades": 23,
      "sell_trades": 19,
      "unique_traders": 31,
      "sentiment_score": 0.26,
      "sentiment_label": "positive",
      "end_date": "2026-04-20T23:59:00Z",
      "active": true,
      "market_status": "tradable",
      "fetched_at": "2026-04-20T15:00:00Z"
    }
  ]
}

Changes

  • 7e8bdb1e7e75Revision changes
    • warning

      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])

    • info

      added the non-success response with the status

  • a74a23b969c4Revision changes
    • info

      deleted the query request parameter days with deprecation