Docs
Market Signals

Market Signals

Fetch all signals for a specific market with time range and type filters. Reference for GET /signals/market/{market_id}.

Overview

Returns all signals ever generated for a specific market, ordered by time descending. Useful for building a signal history view for a given market or auditing signal accuracy.

Endpoint: GET /v1/signals/market/{market_id}

Request

GET /v1/signals/market/0xabc123...?type=ALL&limit=50

Path Parameters

ParameterDescription
market_idPolymarket market ID

Query Parameters

ParameterTypeDefaultDescription
typeStringnullSMART_MONEY_FLOW — omit for all
limitInt50Maximum results (1–100)
cursorStringnullPagination cursor

Response

{
  "data": [
    {
      "signal_id": "...",
      "signal_type": "SMART_MONEY_FLOW",
      "timestamp": "2026-04-01T09:03:11Z",
      "signal_expiry": "2026-04-01T15:03:11Z",
      "market": {
        "platform": "polymarket",
        "market_id": "0xabc123...",
        "question": "Will ETH reach $5000 before June?",
        "category": "CRYPTO",
        "volume_24h": 215000,
        "market_closes_at": "2026-06-01T00:00:00Z"
      },
      "signal": { ... },
      "analysis": { ... }
    }
  ],
  "pagination": {
    "next_cursor": "2026-03-31T22:10:00Z",
    "has_more": true
  }
}

The market object is enriched in this endpoint and includes platform, market_id, question, category, volume_24h, and market_closes_at.

Example: Fetch a Market's Full Signal History

# Page 1
GET /v1/signals/market/0xabc?limit=50
 
# Page 2 (using cursor from previous response)
GET /v1/signals/market/0xabc?limit=50&cursor=2026-03-31T22:10:00Z
 
# Filter to smart money only
GET /v1/signals/market/0xabc?type=SMART_MONEY_FLOW