Market & Trade Data

Polymarket Markets

Search Polymarket markets by condition ID, slug prefix, volume, or resolution status. For sport markets, use slug prefixes:
- nba- → all NBA markets
- nfl- → all NFL markets
- epl- → all EPL markets
- mlb- → all MLB markets
- nhl- → all NHL markets

POST/v2/semantic/retrieve/parameterized

Query Parameters

condition_idstring

Hex condition ID of a specific market

market_slugstring

Slug or slug prefix (e.g. 'nba-' for all NBA)

Example:

"nba-"

min_volumestring

Minimum traded volume in USD

Example:

"10000"

closedstring

'True' for resolved, 'False' for open. Omit for both.

Example:

"False"

end_date_minstring

Unix timestamp (seconds) for earliest end date

Example:

"1600000000"

end_date_maxstring

Unix timestamp (seconds) for latest end date

Example:

"2200000000"

Response Fields

Field	Type	Description
`condition_id`	String	Market condition ID
`question`	String	Market question
`slug`	String	Market slug
`end_date`	String (ISO 8601)	Market resolution date
`volume`	String (Decimal)	Total traded volume (USD)
`liquidity`	String (Decimal)	Current liquidity
`closed`	Boolean	Whether market is resolved
`side_a_token_id`	String	Token ID for outcome A (needed for candles/orderbook/price jumps)
`side_b_token_id`	String	Token ID for outcome B
`outcome_a`	String	Label for outcome A
`outcome_b`	String	Label for outcome B
`current_price_a`	String (Decimal)	Current price for outcome A
`current_price_b`	String (Decimal)	Current price for outcome B

Tips for Best Results

•Use this to get side_a_token_id / side_b_token_id needed by Price Jumps, Candlesticks, and Orderbook
•Filter with closed: "False" to only see active markets
•Combine slug prefix with min_volume to find liquid sport markets

Polymarket Markets

curl --request POST \
  --url https://narrative.agent.heisenberg.so/api/v2/semantic/retrieve/parameterized \
  --header 'Authorization: Bearer YOUR_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "agent_id": 574,
  "params": {
    "market_slug": "nba-",
    "min_volume": "10000",
    "closed": "False",
    "end_date_min": "1600000000",
    "end_date_max": "2200000000"
  },
  "pagination": {
    "limit": 10,
    "offset": 0
  },
  "formatter_config": {
    "format_type": "raw"
  }
}'

200Example response

{
  "timestamp": "",
  "params": {
    "market_slug": "nba-",
    "min_volume": "10000",
    "closed": "False",
    "end_date_min": "1600000000",
    "end_date_max": "2200000000"
  },
  "pagination": {
    "limit": 20,
    "offset": 0,
    "has_more": true
  },
  "data": {
    "results": [
      {
        "condition_id": "0xabc123def456...",
        "question": "Cavaliers vs. Celtics",
        "slug": "nba-cle-bos-2026-04-11",
        "end_date": "2026-04-12T00:00:00Z",
        "volume": "523890.44",
        "liquidity": "842190.55",
        "closed": false,
        "side_a_token_id": "85953619064670985626771564660881103494957821937504170459975285010511861618293",
        "side_b_token_id": "98765432109876543210",
        "outcome_a": "Cavaliers",
        "outcome_b": "Celtics",
        "current_price_a": "0.4200",
        "current_price_b": "0.5800"
      }
    ]
  }
}