Polymarket Markets

cURL

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

import requests

response = requests.post(
    "https://narrative.agent.heisenberg.so/api/v2/semantic/retrieve/parameterized",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
    json={
        "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"},
    },
)

print(response.json())

const response = await fetch(
  "https://narrative.agent.heisenberg.so/api/v2/semantic/retrieve/parameterized",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer YOUR_TOKEN",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      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" },
    }),
  }
);

const data = await response.json();

{
  "timestamp": "<string>",
  "params": {
    "condition_id": "<string>",
    "market_slug": "<string>",
    "min_volume": "<string>",
    "closed": "<string>",
    "end_date_min": "<string>",
    "end_date_max": "<string>"
  },
  "pagination": {
    "limit": 123,
    "offset": 123,
    "has_more": true
  },
  "data": {
    "results": [
      {
        "condition_id": "<string>",
        "question": "<string>",
        "slug": "<string>",
        "end_date": "<string>",
        "volume": "<string>",
        "liquidity": "<string>",
        "closed": true,
        "side_a_token_id": "<string>",
        "side_b_token_id": "<string>",
        "outcome_a": "<string>",
        "outcome_b": "<string>",
        "current_price_a": "<string>",
        "current_price_b": "<string>"
      }
    ]
  },
  "request_id": "<string>"
}

POST

api

semantic

retrieve

parameterized

cURL

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

import requests

response = requests.post(
    "https://narrative.agent.heisenberg.so/api/v2/semantic/retrieve/parameterized",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
    json={
        "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"},
    },
)

print(response.json())

const response = await fetch(
  "https://narrative.agent.heisenberg.so/api/v2/semantic/retrieve/parameterized",
  {
    method: "POST",
    headers: {
      Authorization: "Bearer YOUR_TOKEN",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      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" },
    }),
  }
);

const data = await response.json();

{
  "timestamp": "<string>",
  "params": {
    "condition_id": "<string>",
    "market_slug": "<string>",
    "min_volume": "<string>",
    "closed": "<string>",
    "end_date_min": "<string>",
    "end_date_max": "<string>"
  },
  "pagination": {
    "limit": 123,
    "offset": 123,
    "has_more": true
  },
  "data": {
    "results": [
      {
        "condition_id": "<string>",
        "question": "<string>",
        "slug": "<string>",
        "end_date": "<string>",
        "volume": "<string>",
        "liquidity": "<string>",
        "closed": true,
        "side_a_token_id": "<string>",
        "side_b_token_id": "<string>",
        "outcome_a": "<string>",
        "outcome_b": "<string>",
        "current_price_a": "<string>",
        "current_price_b": "<string>"
      }
    ]
  },
  "request_id": "<string>"
}

Platform: Polymarket
Endpoint: POST /v2/semantic/retrieve/parameterized
Authentication: Bearer token 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

Query parameters

All requests use agent_id 574 (Polymarket Markets). Set filters inside params in the playground — all values must be strings.

Parameter	Type	Description
`condition_id`	String	Hex condition ID for an exact market lookup.
`market_slug`	String	Slug or slug prefix (for example, `"nba-"` for all NBA markets).
`min_volume`	String	Minimum traded volume in USD (for example, `"10000"`).
`closed`	String	`"True"` for resolved markets, `"False"` for open. Omit for both.
`end_date_min`	String	Earliest end date: Unix timestamp in seconds.
`end_date_max`	String	Latest end date: Unix timestamp in seconds.

Example Request

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

import requests

response = requests.post(
    "https://narrative.agent.heisenberg.so/api/v2/semantic/retrieve/parameterized",
    headers={"Authorization": "Bearer YOUR_TOKEN"},
    json={
    "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"
    }
}
)

print(response.json())

const response = await fetch("https://narrative.agent.heisenberg.so/api/v2/semantic/retrieve/parameterized", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "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"
  }
})
});

const data = await response.json();

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

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, and 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

Notes

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 makets

Authorizations

Authorization

string

header

required

Your Falcon API key from the dashboard

Body

application/json

agent_id

enum<integer>

default:574

Polymarket Markets agent ID.

Available options:

574

params

object

Filter parameters. All values must be strings.

Hide child attributes

params.condition_id

string

Hex condition ID of a specific market. Use for an exact market lookup.

params.market_slug

string

Slug or slug prefix (for example, "nba-" for all NBA markets).

params.min_volume

string

Minimum traded volume in USD, passed as a string (for example, "10000").

params.closed

enum<string>

"True" for resolved markets, "False" for open markets. Omit to return both.

Available options:

True,

False

params.end_date_min

string

Earliest end date filter: Unix timestamp in seconds, as a string (for example, "1600000000").

params.end_date_max

string

Latest end date filter: Unix timestamp in seconds, as a string (for example, "2200000000").

pagination

object

Hide child attributes

pagination.limit

integer

default:10

Maximum number of records returned per request.

Required range: 1 <= x <= 200

pagination.offset

integer

default:0

Number of records to skip before returning results.

Required range: x >= 0

formatter_config

object

Hide child attributes

formatter_config.format_type

enum<string>

default:raw

Output format. Use "raw" for structured JSON.

Available options:

raw

Response

Success

timestamp

string

read-only

params

object

read-only

Hide child attributes

params.condition_id

string

read-only

params.market_slug

string

read-only

params.min_volume

string

read-only

params.closed

string

read-only

params.end_date_min

string

read-only

params.end_date_max

string

read-only

pagination

object

Hide child attributes

pagination.limit

integer

pagination.offset

integer

pagination.has_more

boolean

data

object

Hide child attributes

data.results

object[]

Hide child attributes

data.results.condition_id

string

Market condition ID

data.results.question

string

Market question

data.results.slug

string

Market slug

data.results.end_date

string

Market resolution date (ISO 8601)

data.results.volume

string

Total traded volume (USD)

data.results.liquidity

string

Current liquidity

data.results.closed

boolean

Whether market is resolved

data.results.side_a_token_id

string

Token ID for outcome A (needed for candles, orderbook, and price jumps)

data.results.side_b_token_id

string

Token ID for outcome B

data.results.outcome_a

string

Label for outcome A

data.results.outcome_b

string

Label for outcome B

data.results.current_price_a

string

Current price for outcome A

data.results.current_price_b

string

Current price for outcome B

request_id

string

Overview

Composite workflows

Polymarket

Kalshi

Social Intelligence

Polymarket Markets

Query parameters

Example Request

Example Response

Response fields

Notes

Authorizations

Body

Response

​Query parameters

​Example Request

​Example Response

​Response fields

​Notes

Authorizations

Body

Response

Query parameters

Example Request

Example Response

Response fields

Notes