v0.2.0-beta

OpenAPI 3.1.0

دریافت بازارهای Kalshi

Felo API Support

MIT

سرور

https://openapi.felo.ai

کتابخانه‌های کلاینت

Shell Curl

Kalshi

Prediction-market data.

Kalshi عملیات

get/v1/beta/kalshi/markets

دریافت بازارهای Kalshi

فهرست بازارهای پیش‌بینی با فیلترهای مستند status، ticker، event، series و مهر زمانی. قرارداد شامل max_updated_ts است اما پارامتر جستجوی متن آزاد را اعلام نمی‌کند. اسکیمای پاسخ را برای رکوردهای بازار و صفحه‌بندی دنبال کنید.

مرجع قیمت‌گذاری

اندازه‌گیری: مبنای هزینه ثابت برای درخواست موفق.
برآورد درخواست مرجع: 0.02 دلار آمریکا.

فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.

پارامترهای پرس‌وجو

cursor
نوع: string

نشانگر صفحه‌بندی. برای دریافت صفحه بعدی نتایج از مقدار نشانگر برگشتی در پاسخ قبلی استفاده کنید. برای صفحه اول خالی بگذارید.
event_ticker
نوع: string

تیکر رویداد برای فیلتر. فقط یک تیکر رویداد پشتیبانی می‌شود.
limit
نوع: integer قالب: int64
حداقل:
0
حداکثر:
1000

تعداد نتایج در هر صفحه. پیش‌فرض 100 است. حداکثر مقدار 1000 است.
max_close_ts
نوع: integer قالب: int64

فیلتر آیتم‌هایی که قبل از این مهر زمانی Unix بسته می‌شوند
max_created_ts
نوع: integer قالب: int64

فیلتر آیتم‌هایی که قبل از این مهر زمانی Unix ایجاد شده‌اند
max_settled_ts
نوع: integer قالب: int64

فیلتر آیتم‌هایی که قبل از این مهر زمانی Unix تسویه شده‌اند
max_updated_ts
نوع: integer قالب: int64

بازگرداندن بازارهایی که فراداده آن‌ها در این مهر زمانی Unix یا قبل از آن (به ثانیه) به‌روزرسانی شده است. فقط تغییرات غیرمعاملاتی را دنبال می‌کند. می‌توان با min_updated_ts و mve_filter=exclude ترکیب کرد. همچنین می‌توان با series_ticker ترکیب کرد که به mve_filter=exclude نیاز دارد. با فیلترهای دیگر ناسازگار است.
min_close_ts
نوع: integer قالب: int64

فیلتر آیتم‌هایی که بعد از این مهر زمانی Unix بسته می‌شوند
min_created_ts
نوع: integer قالب: int64

فیلتر آیتم‌هایی که بعد از این مهر زمانی Unix ایجاد شده‌اند
min_settled_ts
نوع: integer قالب: int64

فیلتر آیتم‌هایی که بعد از این مهر زمانی Unix تسویه شده‌اند
min_updated_ts
نوع: integer قالب: int64

بازگرداندن بازارهایی که فراداده آن‌ها بعد از این مهر زمانی Unix (به ثانیه) به‌روزرسانی شده است. فقط تغییرات غیرمعاملاتی را دنبال می‌کند. می‌توان با max_updated_ts و mve_filter=exclude ترکیب کرد. همچنین می‌توان با series_ticker ترکیب کرد که به mve_filter=exclude نیاز دارد. با فیلترهای دیگر ناسازگار است.
mve_filter
نوع: string فهرست مقادیر

فیلتر بر اساس رویدادهای چندمتغیره (ترکیب‌ها). 'only' فقط رویدادهای چندمتغیره را برمی‌گرداند و 'exclude' آن‌ها را حذف می‌کند.
مقادیر
- only
- exclude
series_ticker
نوع: string

فیلتر بر اساس تیکر سری
status
نوع: string فهرست مقادیر

فیلتر بر اساس وضعیت بازار. برای بازگرداندن بازارها با هر وضعیتی خالی بگذارید.
مقادیر
- unopened
- open
- paused
- closed
- settled
tickers
نوع: string

فیلتر بر اساس تیکرهای مشخص بازار. فهرست جداشده با کاما از تیکرهای بازار برای بازیابی.

پاسخ‌ها

200
نوع: object · Response24B585A0A861_GetMarketsResponse

بازارها با موفقیت واکشی شدند
cursor
نوع: string
الزامی
markets
نوع: array object[] · Response24B585A0A861_Market[]
الزامی
can_close_early
نوع: boolean
الزامی
close_time
نوع: string قالب: date-time
الزامی

the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

created_time
نوع: string قالب: date-time
الزامی

the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

event_ticker
نوع: string
الزامی
expiration_value
نوع: string
الزامی

مقداری که برای تسویه در نظر گرفته شد

last_price_dollars
نوع: string · Response24B585A0A861_FixedPointDollars
الزامی

رشته دلار آمریکایی با نقطه ثابت. بیشتر فیلدهای درخواست 2 تا 4 رقم اعشار را می‌پذیرند (مثلاً "0.56"، "0.5600")؛ پاسخ‌ها تا 6 رقم برمی‌گردانند. بازه‌های قیمت معتبر برای یک بازار معین با ساختار سطوح قیمت همان بازار محدود می‌شوند.

latest_expiration_time
نوع: string قالب: date-time
الزامی

دیرترین زمان ممکن برای انقضای این بازار

market_type
نوع: string فهرست مقادیر
الزامی

نوع بازار را مشخص می‌کند

مقادیر
binary
scalar
no_ask_dollars
نوع: string · Response24B585A0A861_FixedPointDollars
الزامی

رشته دلار آمریکایی با نقطه ثابت. بیشتر فیلدهای درخواست 2 تا 4 رقم اعشار را می‌پذیرند (مثلاً "0.56"، "0.5600")؛ پاسخ‌ها تا 6 رقم برمی‌گردانند. بازه‌های قیمت معتبر برای یک بازار معین با ساختار سطوح قیمت همان بازار محدود می‌شوند.

no_bid_dollars
نوع: string · Response24B585A0A861_FixedPointDollars
الزامی

رشته دلار آمریکایی با نقطه ثابت. بیشتر فیلدهای درخواست 2 تا 4 رقم اعشار را می‌پذیرند (مثلاً "0.56"، "0.5600")؛ پاسخ‌ها تا 6 رقم برمی‌گردانند. بازه‌های قیمت معتبر برای یک بازار معین با ساختار سطوح قیمت همان بازار محدود می‌شوند.

no_sub_title
نوع: string
الزامی

عنوان کوتاه برای سمت no این بازار

notional_value_dollars
نوع: string · Response24B585A0A861_FixedPointDollars
الزامی

رشته دلار آمریکایی با نقطه ثابت. بیشتر فیلدهای درخواست 2 تا 4 رقم اعشار را می‌پذیرند (مثلاً "0.56"، "0.5600")؛ پاسخ‌ها تا 6 رقم برمی‌گردانند. بازه‌های قیمت معتبر برای یک بازار معین با ساختار سطوح قیمت همان بازار محدود می‌شوند.

open_interest_fp
نوع: string · Response24B585A0A861_FixedPointCount
الزامی

رشته تعداد قرارداد با نقطه ثابت (2 رقم اعشار، مثلاً "10.00"؛ در نام فیلدها "fp" نامیده می‌شود). درخواست‌ها 0 تا 2 رقم اعشار را می‌پذیرند (مثلاً "10"، "10.0"، "10.00")؛ پاسخ‌ها همیشه 2 رقم اعشار برمی‌گردانند. مقادیر کسری قرارداد (مثلاً "2.50") پشتیبانی می‌شوند؛ حداقل دانه‌بندی 0.01 قرارداد است.

open_time
نوع: string قالب: date-time
الزامی

the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

previous_price_dollars
نوع: string · Response24B585A0A861_FixedPointDollars
الزامی

رشته دلار آمریکایی با نقطه ثابت. بیشتر فیلدهای درخواست 2 تا 4 رقم اعشار را می‌پذیرند (مثلاً "0.56"، "0.5600")؛ پاسخ‌ها تا 6 رقم برمی‌گردانند. بازه‌های قیمت معتبر برای یک بازار معین با ساختار سطوح قیمت همان بازار محدود می‌شوند.

previous_yes_ask_dollars
نوع: string · Response24B585A0A861_FixedPointDollars
الزامی

رشته دلار آمریکایی با نقطه ثابت. بیشتر فیلدهای درخواست 2 تا 4 رقم اعشار را می‌پذیرند (مثلاً "0.56"، "0.5600")؛ پاسخ‌ها تا 6 رقم برمی‌گردانند. بازه‌های قیمت معتبر برای یک بازار معین با ساختار سطوح قیمت همان بازار محدود می‌شوند.

previous_yes_bid_dollars
نوع: string · Response24B585A0A861_FixedPointDollars
الزامی

رشته دلار آمریکایی با نقطه ثابت. بیشتر فیلدهای درخواست 2 تا 4 رقم اعشار را می‌پذیرند (مثلاً "0.56"، "0.5600")؛ پاسخ‌ها تا 6 رقم برمی‌گردانند. بازه‌های قیمت معتبر برای یک بازار معین با ساختار سطوح قیمت همان بازار محدود می‌شوند.

price_level_structure
نوع: string
الزامی

ساختار سطوح قیمت این بازار که بازه‌های قیمت و اندازه گام را تعیین می‌کند

price_ranges
نوع: array object[] · Response24B585A0A861_PriceRange[]
الزامی

بازه‌های قیمت معتبر برای سفارش‌ها در این بازار

end
نوع: string
الزامی

قیمت پایانی این بازه به دلار

start
نوع: string
الزامی

قیمت شروع این بازه به دلار

step
نوع: string
الزامی

گام قیمت/اندازه تیک برای این بازه به دلار

result
نوع: string فهرست مقادیر
الزامی
مقادیر
yes
no
scalar
rules_primary
نوع: string
الزامی

توصیفی به زبان ساده از مهم‌ترین شرایط بازار

rules_secondary
نوع: string
الزامی

توصیفی به زبان ساده از شرایط بازار ثانویه

settlement_bounds_type
نوع: string فهرست مقادیر
الزامی

کدام حدود تسویه برای این بازار اعمال می‌شود. default یعنی بازار حد تسویه ندارد

مقادیر
default
floor
settlement_timer_seconds
نوع: integer
الزامی

مدت زمان پس از تعیین نتیجه تا تسویه بازار

status
نوع: string فهرست مقادیر
الزامی

وضعیت فعلی بازار در چرخه عمر آن.

مقادیر
initialized
inactive
active
closed
determined
disputed
amended
finalized
ticker
نوع: string
الزامی
updated_time
نوع: string قالب: date-time
الزامی

زمان آخرین به‌روزرسانی فراداده غیرمعاملاتی.

volume_24h_fp
نوع: string · Response24B585A0A861_FixedPointCount
الزامی

رشته تعداد قرارداد با نقطه ثابت (2 رقم اعشار، مثلاً "10.00"؛ در نام فیلدها "fp" نامیده می‌شود). درخواست‌ها 0 تا 2 رقم اعشار را می‌پذیرند (مثلاً "10"، "10.0"، "10.00")؛ پاسخ‌ها همیشه 2 رقم اعشار برمی‌گردانند. مقادیر کسری قرارداد (مثلاً "2.50") پشتیبانی می‌شوند؛ حداقل دانه‌بندی 0.01 قرارداد است.

volume_fp
نوع: string · Response24B585A0A861_FixedPointCount
الزامی

رشته تعداد قرارداد با نقطه ثابت (2 رقم اعشار، مثلاً "10.00"؛ در نام فیلدها "fp" نامیده می‌شود). درخواست‌ها 0 تا 2 رقم اعشار را می‌پذیرند (مثلاً "10"، "10.0"، "10.00")؛ پاسخ‌ها همیشه 2 رقم اعشار برمی‌گردانند. مقادیر کسری قرارداد (مثلاً "2.50") پشتیبانی می‌شوند؛ حداقل دانه‌بندی 0.01 قرارداد است.

yes_ask_dollars
نوع: string · Response24B585A0A861_FixedPointDollars
الزامی

رشته دلار آمریکایی با نقطه ثابت. بیشتر فیلدهای درخواست 2 تا 4 رقم اعشار را می‌پذیرند (مثلاً "0.56"، "0.5600")؛ پاسخ‌ها تا 6 رقم برمی‌گردانند. بازه‌های قیمت معتبر برای یک بازار معین با ساختار سطوح قیمت همان بازار محدود می‌شوند.

yes_ask_size_fp
نوع: string · Response24B585A0A861_FixedPointCount
الزامی

رشته تعداد قرارداد با نقطه ثابت (2 رقم اعشار، مثلاً "10.00"؛ در نام فیلدها "fp" نامیده می‌شود). درخواست‌ها 0 تا 2 رقم اعشار را می‌پذیرند (مثلاً "10"، "10.0"، "10.00")؛ پاسخ‌ها همیشه 2 رقم اعشار برمی‌گردانند. مقادیر کسری قرارداد (مثلاً "2.50") پشتیبانی می‌شوند؛ حداقل دانه‌بندی 0.01 قرارداد است.

yes_bid_dollars
نوع: string · Response24B585A0A861_FixedPointDollars
الزامی

رشته دلار آمریکایی با نقطه ثابت. بیشتر فیلدهای درخواست 2 تا 4 رقم اعشار را می‌پذیرند (مثلاً "0.56"، "0.5600")؛ پاسخ‌ها تا 6 رقم برمی‌گردانند. بازه‌های قیمت معتبر برای یک بازار معین با ساختار سطوح قیمت همان بازار محدود می‌شوند.

yes_bid_size_fp
نوع: string · Response24B585A0A861_FixedPointCount
الزامی

رشته تعداد قرارداد با نقطه ثابت (2 رقم اعشار، مثلاً "10.00"؛ در نام فیلدها "fp" نامیده می‌شود). درخواست‌ها 0 تا 2 رقم اعشار را می‌پذیرند (مثلاً "10"، "10.0"، "10.00")؛ پاسخ‌ها همیشه 2 رقم اعشار برمی‌گردانند. مقادیر کسری قرارداد (مثلاً "2.50") پشتیبانی می‌شوند؛ حداقل دانه‌بندی 0.01 قرارداد است.

yes_sub_title
نوع: string
الزامی

عنوان کوتاه‌شده برای سمت «بله» این بازار

cap_strike
نوع: number | null قالب: double

حداکثر مقدار انقضا که به تسویه YES منجر می‌شود

custom_strike
نوع: object | null

مقدار انقضا برای هر هدف که به تسویه YES منجر می‌شود

early_close_condition
نوع: string | null

شرطی که تحت آن بازار می‌تواند زودتر بسته شود

exchange_index
نوع: integer · Response24B585A0A861_ExchangeIndex

شناسه یک شارد صرافی.

expected_expiration_time
نوع: string | null قالب: date-time

زمانی که انتظار می‌رود این بازار منقضی شود

expiration_time
نوع: string قالب: date-time
منسوخ

the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

fee_waiver_expiration_time
نوع: string | null قالب: date-time

زمانی که معافیت کارمزد این بازار منقضی می‌شود

floor_strike
نوع: number | null قالب: double

حداقل مقدار انقضا که به تسویه YES منجر می‌شود

functional_strike
نوع: string | null

نگاشت مقادیر انقضا به مقادیر تسویه

is_provisional
نوع: boolean

اگر true باشد، بازار ممکن است پس از تعیین در صورت نداشتن فعالیت حذف شود

mve_collection_ticker
نوع: string

تیکر مجموعه رویدادهای چندمتغیره

mve_selected_legs
نوع: array object[] · Response24B585A0A861_MveSelectedLeg[]
event_ticker
نوع: string

شناسه یکتای رویداد انتخاب‌شده

market_ticker
نوع: string

شناسه یکتای بازار انتخاب‌شده

side
نوع: string

سمت بازار انتخاب‌شده

yes_settlement_value_dollars
نوع: string · Response24B585A0A861_FixedPointDollars

رشته دلار آمریکایی با نقطه ثابت. بیشتر فیلدهای درخواست 2 تا 4 رقم اعشار را می‌پذیرند (مثلاً "0.56"، "0.5600")؛ پاسخ‌ها تا 6 رقم برمی‌گردانند. بازه‌های قیمت معتبر برای یک بازار معین با ساختار سطوح قیمت همان بازار محدود می‌شوند.

occurrence_datetime
نوع: string | null قالب: date-time

تاریخ و زمان ثبت‌شده وقوع رویداد زیربنایی، در صورت وجود

primary_participant_key
نوع: string | null
settlement_floor_dollars
نوع: string · Response24B585A0A861_FixedPointDollars

رشته دلار آمریکایی با نقطه ثابت. بیشتر فیلدهای درخواست 2 تا 4 رقم اعشار را می‌پذیرند (مثلاً "0.56"، "0.5600")؛ پاسخ‌ها تا 6 رقم برمی‌گردانند. بازه‌های قیمت معتبر برای یک بازار معین با ساختار سطوح قیمت همان بازار محدود می‌شوند.

settlement_ts
نوع: string | null قالب: date-time

برچسب زمانی تسویه بازار. فقط برای بازارهای تسویه‌شده پر می‌شود

settlement_value_dollars
نوع: string · Response24B585A0A861_FixedPointDollars

رشته دلار آمریکایی با نقطه ثابت. بیشتر فیلدهای درخواست 2 تا 4 رقم اعشار را می‌پذیرند (مثلاً "0.56"، "0.5600")؛ پاسخ‌ها تا 6 رقم برمی‌گردانند. بازه‌های قیمت معتبر برای یک بازار معین با ساختار سطوح قیمت همان بازار محدود می‌شوند.

strike_type
نوع: string فهرست مقادیر

نوع آستانه تعیین می‌کند که آستانه بازار چگونه تعریف و ارزیابی می‌شود

مقادیر
greater
greater_or_equal
less
less_or_equal
between
functional
custom
structured
subtitle
نوع: string
منسوخ
title
نوع: string
منسوخ
application/json
400

درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.
401

یک کلید API معتبر Felo لازم است.
402

درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.
403

حساب مجاز به انجام این عملیات نیست.
429

به سقف درخواست یا هزینه رسیده‌اید.
502

سرویس نتوانست درخواست را کامل کند.
503

سرویس API یا صورت‌حساب موقتاً در دسترس نیست.
504

سرویس هنگام پردازش درخواست به پایان مهلت رسید.
default

پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند

application/json

get/v1/beta/kalshi/markets

curl https://openapi.felo.ai/v1/beta/kalshi/markets \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

نمایش اسکیما

{
  "markets": [
    {
      "ticker": "string",
      "event_ticker": "string",
      "market_type": "binary",
      "yes_sub_title": "string",
      "no_sub_title": "string",
      "created_time": "2026-10-26T08:08:16.607Z",
      "updated_time": "2026-10-26T08:08:16.607Z",
      "open_time": "2026-10-26T08:08:16.607Z",
      "close_time": "2026-10-26T08:08:16.607Z",
      "expected_expiration_time": null,
      "latest_expiration_time": "2026-10-26T08:08:16.607Z",
      "settlement_timer_seconds": 1,
      "status": "initialized",
      "yes_bid_dollars": "0.5600",
      "yes_bid_size_fp": "10.00",
      "yes_ask_dollars": "0.5600",
      "yes_ask_size_fp": "10.00",
      "no_bid_dollars": "0.5600",
      "no_ask_dollars": "0.5600",
      "last_price_dollars": "0.5600",
      "volume_fp": "10.00",
      "volume_24h_fp": "10.00",
      "result": "yes",
      "can_close_early": true,
      "open_interest_fp": "10.00",
      "notional_value_dollars": "0.5600",
      "previous_yes_bid_dollars": "0.5600",
      "previous_yes_ask_dollars": "0.5600",
      "previous_price_dollars": "0.5600",
      "settlement_value_dollars": "0.5600",
      "settlement_ts": null,
      "settlement_bounds_type": "default",
      "settlement_floor_dollars": "0.5600",
      "expiration_value": "string",
      "occurrence_datetime": null,
      "fee_waiver_expiration_time": null,
      "early_close_condition": null,
      "strike_type": "greater",
      "floor_strike": null,
      "cap_strike": null,
      "functional_strike": null,
      "custom_strike": null,
      "rules_primary": "string",
      "rules_secondary": "string",
      "mve_collection_ticker": "string",
      "mve_selected_legs": [
        {
          "event_ticker": "string",
          "market_ticker": "string",
          "side": "string",
          "yes_settlement_value_dollars": "0.5600"
        }
      ],
      "primary_participant_key": null,
      "price_level_structure": "string",
      "price_ranges": [
        {
          "start": "string",
          "end": "string",
          "step": "string"
        }
      ],
      "is_provisional": true,
      "exchange_index": 0
    }
  ],
  "cursor": "string"
}

بازارها با موفقیت واکشی شدند

دریافت بازارهای Kalshi

احراز هویتRequired

Kalshi

دریافت بازارهای Kalshi

مرجع قیمت‌گذاری