Sign in

v1

latestOpenAPI 3.1.0MIT2026-08-0453113564.4 KB
Polymarket Stocks

Raw Mentions

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
  • empty result sets return 200 with results=[]
  • 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

Path parameters

tickerstring required

Stock ticker symbol (e.g., TSLA, $AAPL, BRK.A)

Example:TSLA

Stock ticker symbol (e.g., TSLA, $AAPL, BRK.A)

Query parameters

fromstring date nullable

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

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.

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

daysinteger

Deprecated v1 compatibility shorthand. Prefer from and to for reproducible UTC date windows.

Deprecated v1 compatibility shorthand. Prefer from and to for reproducible UTC date windows.

limitinteger

Maximum number of raw Polymarket snapshot rows to return

Example:50

Maximum number of raw Polymarket snapshot rows to return

offsetinteger

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

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

Response

Successful Response

tickerstring required

Stock ticker symbol

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"
    }
  ]
}