Kalshi
Prediction-market data.
دریافت معاملات Kalshi
نوار معاملات اجراشده بازارهای Kalshi را دریافت کنید — پر شدن‌های واقعی، نه نقل‌قول. وقتی به قیمت‌های محقق‌شده و حجم معامله‌شده در یک بازه نیاز دارید از آن استفاده کنید، مثلاً برای دیدن اینکه اطمینان چگونه در حین شکل‌گیری یک رویداد تغییر کرد؛ با ticker و بازه ثانیه‌ای یونیکس min_ts / max_ts محدود کنید و is_block_trade را برای جداسازی معاملات بزرگ توافقی تنظیم کنید. trades[] را با trade_id، ticker، count_fp (قراردادها)، yes_price_dollars / no_price_dollars، taker_side و created_time، به‌همراه cursor برای صفحه‌بندی برمی‌گرداند. برای نقل‌قول‌های فعلی، قواعد تسویه و فراداده بازار به‌جای پر شدن‌ها، از get_kalshi_markets استفاده کنید.
مرجع قیمت‌گذاری
- اندازه‌گیری: مبنای هزینه ثابت برای درخواست موفق.
- برآورد درخواست مرجع: 0.02 دلار آمریکا.
فقط فراداده مرجع است، نه نقل‌قول حساب، نه قیمت تضمین‌شده و نه سقف هزینه. اعتبار منابع، اعتبار Felo نیست. هزینه‌های نهایی تابع سوابق صورت‌حساب Felo است.
- نوع: stringcursor
نشانگر صفحه‌بندی. برای دریافت صفحه بعدی نتایج از مقدار نشانگر برگشتی در پاسخ قبلی استفاده کنید. برای صفحه اول خالی بگذارید.
- نوع: booleanis
_block _trade فیلتر معاملات بر اساس اینکه معامله بلوکی هستند یا نه. برای بازگرداندن همه معاملات آن را حذف کنید. برای بازگرداندن فقط معاملات بلوکی
trueو برای بازگرداندن فقط معاملات غیربلوکیfalseرا تنظیم کنید. - نوع: integer قالب: int64limitحداقل:0حداکثر:1000
تعداد نتایج در هر صفحه. پیش‌فرض 100 است. حداکثر مقدار 1000 است.
- نوع: integer قالب: int64max
_ts فیلتر آیتم‌ها قبل از این مهر زمانی Unix
- نوع: integer قالب: int64min
_ts فیلتر آیتم‌ها بعد از این مهر زمانی Unix
- نوع: stringticker
فیلتر بر اساس تیکر بازار
- نوع: object · Response24B585A0A861_GetTradesResponse200
معاملات با موفقیت واکشی شدند
- نوع: stringcursorالزامی
- نوع: array object[] · Response24B585A0A861_Trade[]tradesالزامی
- countنوع: string · Response24B585A0A861_FixedPointCount
_fp الزامیرشته تعداد قرارداد با نقطه ثابت (2 رقم اعشار، مثلاً "10.00"؛ در نام فیلدها "fp" نامیده می‌شود). درخواست‌ها 0 تا 2 رقم اعشار را می‌پذیرند (مثلاً "10"، "10.0"، "10.00")؛ پاسخ‌ها همیشه 2 رقم اعشار برمی‌گردانند. مقادیر کسری قرارداد (مثلاً "2.50") پشتیبانی می‌شوند؛ حداقل دانه‌بندی 0.01 قرارداد است.
- createdنوع: string قالب: date-time
_time الزامیبرچسب زمانی اجرای این معامله
- isنوع: boolean
_block _trade الزامیاگر این معامله خارج از دفتر سفارش به‌عنوان معامله بلوکی تطبیق داده شده باشد مقدار True است (مثلاً از طریق RFQ / پیشنهاد بلوکی مذاکره‌شده)؛ برای معاملاتی که در دفتر سفارش استاندارد پر شده‌اند مقدار false است.
- noنوع: string · Response24B585A0A861_FixedPointDollars
_price _dollars الزامیرشته دلار آمریکایی با نقطه ثابت. بیشتر فیلدهای درخواست 2 تا 4 رقم اعشار را می‌پذیرند (مثلاً "0.56"، "0.5600")؛ پاسخ‌ها تا 6 رقم برمی‌گردانند. بازه‌های قیمت معتبر برای یک بازار معین با ساختار سطوح قیمت همان بازار محدود می‌شوند.
- takerنوع: string · Response24B585A0A861_BookSideفهرست مقادیر
_book _side الزامیسمت دفتر سفارشات برای یک سفارش یا معامله. برای بازارهای رویدادی، این به پای YES فقط اشاره دارد:
bidیعنی خرید YES،askیعنی فروش YES. (فروش YES از نظر اقتصادی معادل خرید NO با1 - priceاست، اما این نقطه پایانی همه چیز را از سمت YES قیمت‌گذاری می‌کند.)مقادیر- bid
- ask
- takerنوع: string فهرست مقادیر
_outcome _side الزامیسمت نتیجه‌ای که گیرنده در آن قرار دارد. buy-yes و sell-no مقدار 'yes' تولید می‌کنند؛ buy-no و sell-yes مقدار 'no'.
taker_outcome_sideفقط مواجهه جهت‌دار را توصیف می‌کند و قیمت معامله را تغییر نمی‌دهد. معامله‌ای با قیمتpوtaker_outcome_side=noبا بازارساز در همان قیمتpو جهت مخالف تطبیق داده می‌شود — هر دو طرف با قیمت یکسان معامله می‌کنند.taker_outcome_sideوtaker_book_sideروش متعارف تعیین جهت معامله خواهند شد. فیلد قدیمیtaker_sideدر نسخه‌ای آینده منسوخ می‌شود — لطفاً به این فیلدهای جدید مهاجرت کنید.مقادیر- yes =
Trade Taker Outcome Side Yes - no =
Trade Taker Outcome Side No
- tickerنوع: stringالزامی
شناسه یکتای بازار
- tradeنوع: string
_id الزامیشناسه یکتای این معامله
- yesنوع: string · Response24B585A0A861_FixedPointDollars
_price _dollars الزامیرشته دلار آمریکایی با نقطه ثابت. بیشتر فیلدهای درخواست 2 تا 4 رقم اعشار را می‌پذیرند (مثلاً "0.56"، "0.5600")؛ پاسخ‌ها تا 6 رقم برمی‌گردانند. بازه‌های قیمت معتبر برای یک بازار معین با ساختار سطوح قیمت همان بازار محدود می‌شوند.
- takerنوع: string فهرست مقادیر
_side منسوخمنسوخ. به‌جای آن از
taker_outcome_side(یاtaker_book_side) استفاده کنید. جهت سفارش را ببینید. این فیلد پیش از 14 مه 2026 حذف نخواهد شد.مقادیر- yes =
Trade Taker Side Yes - no =
Trade Taker Side No
application/json - 400
درخواست پردازش نشد. پارامترهای درخواست را بررسی کنید.
- 401
یک کلید API معتبر Felo لازم است.
- 402
درخواست ادامه نمی‌یابد چون یک الزام صورت‌حساب برآورده نشده است.
- 403
حساب مجاز به انجام این عملیات نیست.
- 429
به سقف درخواست یا هزینه رسیده‌اید.
- 502
سرویس نتوانست درخواست را کامل کند.
- 503
سرویس API یا صورت‌حساب موقتاً در دسترس نیست.
- 504
سرویس هنگام پردازش درخواست به پایان مهلت رسید.
- default
پاسخ خطا؛ پاسخ‌های عبوری بالادست ممکن است از قالب‌های ارائه‌دهنده استفاده کنند
application/json
curl https://openapi.felo.ai/v1/beta/kalshi/trades \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"trades": [
{
"trade_id": "string",
"ticker": "string",
"count_fp": "10.00",
"yes_price_dollars": "0.5600",
"no_price_dollars": "0.5600",
"taker_outcome_side": "yes",
"taker_book_side": "bid",
"created_time": "2026-10-26T08:08:16.678Z",
"is_block_trade": true
}
],
"cursor": "string"
}