Kalshi
Prediction-market data.
Отримати угоди Kalshi
Отримує стрічку виконаних угод для ринків Kalshi — фактичні виконання, а не котирування. Використовуйте, коли потрібні реалізовані ціни та обсяг торгів за період, наприклад щоб побачити, як змінювалася впевненість у міру розвитку події; звужте за допомогою ticker і діапазону min_ts / max_ts в Unix-секундах, а is_block_trade задайте, щоб виокремити великі договірні угоди. Повертає trades[] з trade_id, ticker, count_fp (контракти), yes_price_dollars / no_price_dollars, taker_side і created_time, а також cursor для посторінкового виводу. Для поточних котирувань, правил розрахунку й метаданих ринку, а не виконань, використовуйте get_kalshi_markets.
Довідкові ціни
- Тарифікація: фіксована базова вартість успішного запиту.
- Довідкова оцінка запиту: USD 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.607Z",
"is_block_trade": true
}
],
"cursor": "string"
}