# 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 | 1 ページあたりの結果数。既定は 100 です。最大値は 1000 です。 |
| `max_ts` | query | no | integer, (int64) | この Unix タイムスタンプより前の項目をフィルター |
| `min_ts` | query | no | integer, (int64) | この Unix タイムスタンプより後の項目をフィルター |
| `ticker` | query | no | string | マーケット ticker でフィルター |

## Responses

### 200 — 取引の取得に成功しました

Headers:
- `X-Request-Id` (string) — Felo サポートに問い合わせる際に伝えるリクエスト識別子。

**application/json**

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

### 400 — リクエストを処理できませんでした。リクエストパラメータを確認してください。

### 401 — 有効な Felo API キーが必要です。

### 402 — 請求要件が満たされていないため、リクエストを続行できません。

### 403 — このアカウントにはこの操作を行う権限がありません。

### 429 — リクエストまたは支出の上限に達しました。

### 502 — サービスがリクエストを完了できませんでした。

### 503 — API または請求サービスが一時的に利用できません。

### 504 — リクエストの処理中にサービスがタイムアウトしました。

### default — エラーレスポンス。上流のパススルーレスポンスはプロバイダーの形式を使用する場合があります

**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 の売りは `1 - price` で NO を買うことと経済的に同等ですが、このエンドポイントはすべてを 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)を参照してください。このフィールドは 2026 年 5 月 14 日より前に削除されることはありません。\n"
    },
    "taker_outcome_side": {
      "type": "string",
      "enum": [
        "yes",
        "no"
      ],
      "x-enum-varnames": [
        "TradeTakerOutcomeSideYes",
        "TradeTakerOutcomeSideNo"
      ],
      "description": "taker が持つ結果側です。buy-yes と sell-no は 'yes' を、buy-no と sell-yes は 'no' を生成します。\n\n`taker_outcome_side` は方向性のエクスポージャーのみを表し、取引価格は変わりません。価格 `p` で `taker_outcome_side=no` の取引は、逆方向で同じ価格 `p` の maker とマッチングされます。双方は同じ価格で取引します。\n\n`taker_outcome_side` と `taker_book_side` が取引方向を判定する標準的な方法になります。従来の `taker_side` フィールドは将来のリリースで非推奨になります。これらの新しいフィールドに移行してください。\n"
    },
    "taker_book_side": {
      "$ref": "#/components/schemas/Response24B585A0A861_BookSide"
    },
    "created_time": {
      "type": "string",
      "format": "date-time",
      "description": "この取引が執行されたタイムスタンプ"
    },
    "is_block_trade": {
      "type": "boolean",
      "description": "この取引が大口の交渉取引としてオーダーブック外でマッチングされた場合（例：RFQ / 交渉による大口提案）は true、標準のオーダーブックで約定した取引は false です。"
    }
  }
}
```