Kalshi 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": 565,
  "params": {
    "ticker": "KXSOL15M-26MAR180800-00",
    "event_ticker": "KXSOL15M-26MAR180800",
    "title": "SOL price",
    "status": "finalized",
    "close_time_min": "1773589812",
    "close_time_max": "1774021812"
  },
  "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": 565,
        "params": {
            "ticker": "KXSOL15M-26MAR180800-00",
            "event_ticker": "KXSOL15M-26MAR180800",
            "title": "SOL price",
            "status": "finalized",
            "close_time_min": "1773589812",
            "close_time_max": "1774021812",
        },
        "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: 565,
      params: {
        ticker: "KXSOL15M-26MAR180800-00",
        event_ticker: "KXSOL15M-26MAR180800",
        title: "SOL price",
        status: "finalized",
        close_time_min: "1773589812",
        close_time_max: "1774021812",
      },
      pagination: { limit: 10, offset: 0 },
      formatter_config: { format_type: "raw" },
    }),
  }
);

const data = await response.json();

{
  "timestamp": "<string>",
  "params": {
    "ticker": "<string>",
    "event_ticker": "<string>",
    "title": "<string>",
    "status": "<string>",
    "close_time_min": "<string>",
    "close_time_max": "<string>"
  },
  "pagination": {
    "limit": 123,
    "offset": 123,
    "has_more": true
  },
  "data": {
    "results": [
      {}
    ]
  },
  "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": 565,
  "params": {
    "ticker": "KXSOL15M-26MAR180800-00",
    "event_ticker": "KXSOL15M-26MAR180800",
    "title": "SOL price",
    "status": "finalized",
    "close_time_min": "1773589812",
    "close_time_max": "1774021812"
  },
  "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": 565,
        "params": {
            "ticker": "KXSOL15M-26MAR180800-00",
            "event_ticker": "KXSOL15M-26MAR180800",
            "title": "SOL price",
            "status": "finalized",
            "close_time_min": "1773589812",
            "close_time_max": "1774021812",
        },
        "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: 565,
      params: {
        ticker: "KXSOL15M-26MAR180800-00",
        event_ticker: "KXSOL15M-26MAR180800",
        title: "SOL price",
        status: "finalized",
        close_time_min: "1773589812",
        close_time_max: "1774021812",
      },
      pagination: { limit: 10, offset: 0 },
      formatter_config: { format_type: "raw" },
    }),
  }
);

const data = await response.json();

{
  "timestamp": "<string>",
  "params": {
    "ticker": "<string>",
    "event_ticker": "<string>",
    "title": "<string>",
    "status": "<string>",
    "close_time_min": "<string>",
    "close_time_max": "<string>"
  },
  "pagination": {
    "limit": 123,
    "offset": 123,
    "has_more": true
  },
  "data": {
    "results": [
      {}
    ]
  },
  "request_id": "<string>"
}

Platform: Kalshi
Endpoint: POST /v2/semantic/retrieve/parameterized
Authentication: Bearer token

Query parameters

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

Parameter	Type	Description
`ticker`	String	Market ticker (exact match).
`event_ticker`	String	Event ticker.
`title`	String	Market title search text.
`status`	String	Market status (for example, `active` or `finalized`).
`close_time_min`	String	Close time at or after this Unix timestamp in seconds.
`close_time_max`	String	Close time at or before this 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": 565,
  "params": {
    "ticker": "KXSOL15M-26MAR180800-00",
    "event_ticker": "KXSOL15M-26MAR180800",
    "title": "SOL price",
    "status": "finalized",
    "close_time_min": "1773589812",
    "close_time_max": "1774021812"
  },
  "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": 565,
    "params": {
        "ticker": "KXSOL15M-26MAR180800-00",
        "event_ticker": "KXSOL15M-26MAR180800",
        "title": "SOL price",
        "status": "finalized",
        "close_time_min": "1773589812",
        "close_time_max": "1774021812"
    },
    "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": 565,
  "params": {
    "ticker": "KXSOL15M-26MAR180800-00",
    "event_ticker": "KXSOL15M-26MAR180800",
    "title": "SOL price",
    "status": "finalized",
    "close_time_min": "1773589812",
    "close_time_max": "1774021812"
  },
  "pagination": {
    "limit": 10,
    "offset": 0
  },
  "formatter_config": {
    "format_type": "raw"
  }
})
});

const data = await response.json();

Example Response

{
  "timestamp": "",
  "params": {
    "close_time_max": "1774021812",
    "close_time_min": "1773589812",
    "event_ticker": "KXSOL15M-26MAR180800",
    "status": "finalized",
    "ticker": "KXSOL15M-26MAR180800-00",
    "title": "SOL price"
  },
  "pagination": {
    "limit": 10,
    "offset": 0,
    "has_more": false
  },
  "data": {
    "results": [
      {
        "close_time": "2026-03-18T12:00:00Z",
        "created_time": "2026-03-18T00:01:21.613032Z",
        "event_ticker": "KXSOL15M-26MAR180800",
        "expiration_time": "2026-03-25T12:00:00Z",
        "last_price": 0.8,
        "open_time": "2026-03-18T11:45:00Z",
        "result": "no",
        "status": "finalized",
        "ticker": "KXSOL15M-26MAR180800-00",
        "title": "SOL price up in next 15 mins?",
        "volume": 4422,
        "volume_24h": 4422
      }
    ]
  }
}

Response fields

Field	Type	Description
`close_time`	String (ISO 8601)	Timestamp when the market was closed to trading
`created_time`	String (ISO 8601)	Timestamp when the market was created
`event_ticker`	String	Event ticker
`expiration_time`	String (ISO 8601)	Timestamp when the market expires and is no longer valid
`last_price`	Integer	Last traded price of the market
`open_time`	String (ISO 8601)	Timestamp when the market opened for trading
`status`	String	Current market status (for example, `active`, `finalized`)
`ticker`	String	Ticker for this specific market
`title`	String	Market question describing the event and outcome being traded
`volume`	Integer	Total trading volume for the market
`volume_24h`	Integer	Trading volume in the last 24 hours
`result`	String	Final result (outcome) of this market

Authorizations

Authorization

string

header

required

Your Falcon API key from the dashboard

Body

application/json

params

object

required

Filter parameters. All values must be strings.

Hide child attributes

params.ticker

string

default:KXSOL15M-26MAR180800-00

Market ticker (exact match).

params.event_ticker

string

default:KXSOL15M-26MAR180800

Event ticker.

params.title

string

default:SOL price

Market title search text.

params.status

enum<string>

default:finalized

Market status (for example, active or finalized).

Available options:

active,

finalized

params.close_time_min

string

default:1773589812

Close time at or after this Unix timestamp in seconds, inclusive.

params.close_time_max

string

default:1774021812

Close time at or before this Unix timestamp in seconds, inclusive.

agent_id

enum<integer>

default:565

Kalshi Markets agent ID.

Available options:

565

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

string

read-only

params.event_ticker

string

read-only

params.title

string

read-only

params.status

string

read-only

params.close_time_min

string

read-only

params.close_time_max

string

read-only

pagination

object

read-only

Hide child attributes

pagination.limit

integer

read-only

pagination.offset

integer

read-only

pagination.has_more

boolean

read-only

data

object

read-only

Hide child attributes

data.results

object[]

read-only

request_id

string

read-only

Overview

Composite workflows

Polymarket

Kalshi

Social Intelligence

Kalshi Markets

Query parameters

Example Request

Example Response

Response fields

Authorizations

Body

Response

​Query parameters

​Example Request

​Example Response

​Response fields

Authorizations

Body

Response

Query parameters

Example Request

Example Response

Response fields