# Получить сделки Kalshi

**API:** Data API

**Endpoint:** `GET /v1/beta/kalshi/trades`

**Tags:** 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.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `cursor` | query | no | string | Курсор пагинации. Используйте значение курсора из предыдущего ответа, чтобы получить следующую страницу результатов. Для первой страницы оставьте пустым. |
| `is_block_trade` | query | no | boolean | Фильтрует сделки по признаку блоковой сделки. Опустите, чтобы вернуть все сделки. Установите `true`, чтобы возвращать только блоковые сделки. Установите `false`, чтобы возвращать только неблоковые сделки. |
| `limit` | query | no | integer, (int64), default: 100 | Количество результатов на страницу. По умолчанию 100. Максимальное значение — 1000. |
| `max_ts` | query | no | integer, (int64) | Фильтрует элементы до этой Unix-временной метки |
| `min_ts` | query | no | integer, (int64) | Фильтрует элементы после этой Unix-временной метки |
| `ticker` | query | no | string | Фильтр по тикеру рынка |

## Responses

### 200 — Сделки успешно получены

Headers:
- `X-Request-Id` (string) — Идентификатор запроса, который нужно указать при обращении в поддержку Felo.

**application/json**

Schema: `Response24B585A0A861_GetTradesResponse` (`#/components/schemas/Response24B585A0A861_GetTradesResponse`)

### 400 — Запрос не удалось обработать. Проверьте параметры запроса.

### 401 — Требуется действительный API-ключ Felo.

### 402 — Запрос не может быть выполнен: не выполнено требование биллинга.

### 403 — Аккаунту не разрешено выполнять эту операцию.

### 429 — Достигнут лимит запросов или расходов.

### 502 — Сервис не смог выполнить запрос.

### 503 — API или сервис биллинга временно недоступны.

### 504 — Истекло время ожидания обработки запроса.

### default — Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response24B585A0A861_BookSide

`#/components/schemas/Response24B585A0A861_BookSide`

```json
{
  "type": "string",
  "enum": [
    "bid",
    "ask"
  ],
  "description": "Сторона книги заявок для ордера или сделки. Для событийных рынков это относится только к плечу YES: `bid` означает покупку YES, `ask` — продажу YES. (Продажа YES экономически эквивалентна покупке NO по `1 - price`, но этот эндпоинт котирует всё со стороны YES.)"
}
```

### Response24B585A0A861_FixedPointCount

`#/components/schemas/Response24B585A0A861_FixedPointCount`

```json
{
  "type": "string",
  "description": "Строка количества контрактов с фиксированной точкой (2 знака после запятой, например \"10.00\"; в именах полей обозначается как \"fp\"). Запросы принимают 0-2 знака после запятой (например, \"10\", \"10.0\", \"10.00\"); ответы всегда содержат 2 знака. Дробные значения контрактов (например, \"2.50\") поддерживаются; минимальная гранулярность — 0.01 контракта.",
  "example": "10.00"
}
```

### Response24B585A0A861_FixedPointDollars

`#/components/schemas/Response24B585A0A861_FixedPointDollars`

```json
{
  "type": "string",
  "description": "Строка суммы в долларах США с фиксированной точкой. Большинство полей запроса принимают 2-4 знака после запятой (например, \"0.56\", \"0.5600\"); ответы содержат до 6 знаков. Допустимые интервалы котировок для данного рынка ограничены структурой уровней цен этого рынка.",
  "example": "0.5600"
}
```

### Response24B585A0A861_GetTradesResponse

`#/components/schemas/Response24B585A0A861_GetTradesResponse`

```json
{
  "type": "object",
  "required": [
    "trades",
    "cursor"
  ],
  "properties": {
    "trades": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Response24B585A0A861_Trade"
      }
    },
    "cursor": {
      "type": "string"
    }
  }
}
```

### Response24B585A0A861_Trade

`#/components/schemas/Response24B585A0A861_Trade`

```json
{
  "type": "object",
  "required": [
    "trade_id",
    "ticker",
    "count_fp",
    "yes_price_dollars",
    "no_price_dollars",
    "taker_outcome_side",
    "taker_book_side",
    "created_time",
    "is_block_trade"
  ],
  "properties": {
    "trade_id": {
      "type": "string",
      "description": "Уникальный идентификатор этой сделки."
    },
    "ticker": {
      "type": "string",
      "description": "Уникальный идентификатор рынка."
    },
    "count_fp": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointCount"
    },
    "yes_price_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "no_price_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "taker_side": {
      "type": "string",
      "enum": [
        "yes",
        "no"
      ],
      "x-enum-varnames": [
        "TradeTakerSideYes",
        "TradeTakerSideNo"
      ],
      "deprecated": true,
      "x-go-type-skip-optional-pointer": true,
      "description": "Устарело. Используйте `taker_outcome_side` (или `taker_book_side`). См. [Направление ордера](/getting_started/order_direction). Поле не будет удалено ранее 14 мая 2026 года."
    },
    "taker_outcome_side": {
      "type": "string",
      "enum": [
        "yes",
        "no"
      ],
      "x-enum-varnames": [
        "TradeTakerOutcomeSideYes",
        "TradeTakerOutcomeSideNo"
      ],
      "description": "Сторона исхода, на которую ориентируется тейкер. buy-yes и sell-no дают 'yes'; buy-no и sell-yes дают 'no'.\n\n`taker_outcome_side` описывает только направленную экспозицию и не влияет на цену сделки. Сделка по цене `p` с `taker_outcome_side=no` сопоставляется с мейкером по той же цене `p` в противоположном направлении — обе стороны торгуют по одной цене.\n\n`taker_outcome_side` и `taker_book_side` станут каноническим способом определения направления сделки. Устаревшее поле `taker_side` будет объявлено устаревшим в одном из будущих выпусков — переходите на новые поля."
    },
    "taker_book_side": {
      "$ref": "#/components/schemas/Response24B585A0A861_BookSide"
    },
    "created_time": {
      "type": "string",
      "format": "date-time",
      "description": "Временная метка исполнения этой сделки."
    },
    "is_block_trade": {
      "type": "boolean",
      "description": "Значение true, если сделка была совершена вне книги как блочная (например, через RFQ или согласованное блочное предложение); false для сделок, исполненных в стандартном стакане."
    }
  }
}
```