# Kalshi 시장 조회

**API:** Data API

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

**Tags:** Kalshi

문서화된 status, ticker, event, series, 타임스탬프 필터로 예측 시장을 나열합니다. 계약에는 max_updated_ts가 포함되어 있지만 자유 텍스트 검색 매개변수는 선언되어 있지 않습니다. 시장 레코드와 페이지네이션은 응답 스키마를 따르세요.

### 가격 참고

- 과금 기준: 성공한 요청당 고정 원가 기준.
- 참고 요청 추정치: 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 | 페이지네이션 커서입니다. 이전 응답에서 반환된 커서 값을 사용해 다음 결과 페이지를 가져옵니다. 첫 페이지는 비워 두세요. |
| `event_ticker` | query | no | string | 필터링할 이벤트 티커입니다. 이벤트 티커 하나만 지원됩니다. |
| `limit` | query | no | integer, (int64), default: 100 | 페이지당 결과 수입니다. 기본값은 100입니다. 최대값은 1000입니다. |
| `max_close_ts` | query | no | integer, (int64) | 이 Unix 타임스탬프 이전에 종료되는 항목을 필터링합니다 |
| `max_created_ts` | query | no | integer, (int64) | 이 Unix 타임스탬프 이전에 생성된 항목을 필터링합니다 |
| `max_settled_ts` | query | no | integer, (int64) | 이 Unix 타임스탬프 이전에 정산된 항목을 필터링합니다 |
| `max_updated_ts` | query | no | integer, (int64) | 메타데이터가 이 Unix 타임스탬프(초) 또는 그 이전에 업데이트된 시장을 반환합니다. 거래 외 변경 사항만 추적합니다. min_updated_ts 및 mve_filter=exclude와 함께 사용할 수 있습니다. series_ticker와도 함께 사용할 수 있지만 mve_filter=exclude가 필요합니다. 다른 필터와는 함께 사용할 수 없습니다. |
| `min_close_ts` | query | no | integer, (int64) | 이 Unix 타임스탬프 이후에 종료되는 항목을 필터링합니다 |
| `min_created_ts` | query | no | integer, (int64) | 이 Unix 타임스탬프 이후에 생성된 항목을 필터링합니다 |
| `min_settled_ts` | query | no | integer, (int64) | 이 Unix 타임스탬프 이후에 정산된 항목을 필터링합니다 |
| `min_updated_ts` | query | no | integer, (int64) | 메타데이터가 이 Unix 타임스탬프(초) 이후에 업데이트된 시장을 반환합니다. 거래 외 변경 사항만 추적합니다. max_updated_ts 및 mve_filter=exclude와 함께 사용할 수 있습니다. series_ticker와도 함께 사용할 수 있지만 mve_filter=exclude가 필요합니다. 다른 필터와는 함께 사용할 수 없습니다. |
| `mve_filter` | query | no | string, enum: "only", "exclude" | 복합 이벤트(콤보)로 필터링합니다. 'only'는 복합 이벤트만 반환하고, 'exclude'는 복합 이벤트를 제외합니다. |
| `series_ticker` | query | no | string | 시리즈 티커로 필터링 |
| `status` | query | no | string, enum: "unopened", "open", "paused", "closed", "settled" | 시장 상태로 필터링합니다. 모든 상태의 시장을 반환하려면 비워 두세요. |
| `tickers` | query | no | string | 특정 시장 티커로 필터링합니다. 검색할 시장 티커를 쉼표로 구분한 목록입니다. |

## Responses

### 200 — 시장을 성공적으로 가져왔습니다

Headers:
- `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다.

**application/json**

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

### 400 — 요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.

### 401 — 유효한 Felo API 키가 필요합니다.

### 402 — 청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.

### 403 — 이 계정에는 이 작업을 수행할 권한이 없습니다.

### 429 — 요청 또는 지출 한도에 도달했습니다.

### 502 — 서비스가 요청을 완료할 수 없습니다.

### 503 — API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.

### 504 — 요청을 처리하는 동안 서비스 시간이 초과되었습니다.

### default — 오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response24B585A0A861_ExchangeIndex

`#/components/schemas/Response24B585A0A861_ExchangeIndex`

```json
{
  "type": "integer",
  "description": "거래소 샤드의 식별자입니다.",
  "example": 0
}
```

### 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_GetMarketsResponse

`#/components/schemas/Response24B585A0A861_GetMarketsResponse`

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

### Response24B585A0A861_Market

`#/components/schemas/Response24B585A0A861_Market`

```json
{
  "type": "object",
  "required": [
    "ticker",
    "event_ticker",
    "market_type",
    "yes_sub_title",
    "no_sub_title",
    "created_time",
    "updated_time",
    "open_time",
    "close_time",
    "latest_expiration_time",
    "settlement_timer_seconds",
    "status",
    "notional_value_dollars",
    "yes_bid_dollars",
    "yes_ask_dollars",
    "no_bid_dollars",
    "no_ask_dollars",
    "yes_bid_size_fp",
    "yes_ask_size_fp",
    "last_price_dollars",
    "previous_yes_bid_dollars",
    "previous_yes_ask_dollars",
    "previous_price_dollars",
    "volume_fp",
    "volume_24h_fp",
    "open_interest_fp",
    "result",
    "can_close_early",
    "expiration_value",
    "rules_primary",
    "rules_secondary",
    "price_level_structure",
    "price_ranges",
    "settlement_bounds_type"
  ],
  "properties": {
    "ticker": {
      "type": "string"
    },
    "event_ticker": {
      "type": "string"
    },
    "market_type": {
      "type": "string",
      "enum": [
        "binary",
        "scalar"
      ],
      "description": "시장 유형을 식별합니다"
    },
    "title": {
      "type": "string",
      "deprecated": true,
      "x-go-type-skip-optional-pointer": true
    },
    "subtitle": {
      "type": "string",
      "deprecated": true,
      "x-go-type-skip-optional-pointer": true
    },
    "yes_sub_title": {
      "type": "string",
      "description": "이 시장의 예(yes) 측에 대한 축약 제목입니다."
    },
    "no_sub_title": {
      "type": "string",
      "description": "이 시장의 NO 쪽에 대한 축약 제목"
    },
    "created_time": {
      "type": "string",
      "format": "date-time"
    },
    "updated_time": {
      "type": "string",
      "format": "date-time",
      "description": "마지막으로 거래와 무관한 메타데이터가 업데이트된 시각입니다."
    },
    "open_time": {
      "type": "string",
      "format": "date-time"
    },
    "close_time": {
      "type": "string",
      "format": "date-time"
    },
    "expected_expiration_time": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "x-omitempty": true,
      "description": "이 시장이 만료될 것으로 예상되는 시각"
    },
    "expiration_time": {
      "type": "string",
      "format": "date-time",
      "deprecated": true,
      "x-go-type-skip-optional-pointer": true
    },
    "latest_expiration_time": {
      "type": "string",
      "format": "date-time",
      "description": "이 시장의 최대 만료 가능 시각"
    },
    "settlement_timer_seconds": {
      "type": "integer",
      "description": "판정 후 시장이 정산되기까지 걸리는 시간입니다."
    },
    "status": {
      "type": "string",
      "enum": [
        "initialized",
        "inactive",
        "active",
        "closed",
        "determined",
        "disputed",
        "amended",
        "finalized"
      ],
      "description": "수명 주기에서 시장의 현재 상태입니다."
    },
    "yes_bid_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "yes_bid_size_fp": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointCount"
    },
    "yes_ask_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "yes_ask_size_fp": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointCount"
    },
    "no_bid_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "no_ask_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "last_price_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "volume_fp": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointCount"
    },
    "volume_24h_fp": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointCount"
    },
    "result": {
      "type": "string",
      "enum": [
        "yes",
        "no",
        "scalar",
        ""
      ]
    },
    "can_close_early": {
      "type": "boolean"
    },
    "open_interest_fp": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointCount"
    },
    "notional_value_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "previous_yes_bid_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "previous_yes_ask_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "previous_price_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "settlement_value_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "settlement_ts": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "x-omitempty": true,
      "description": "시장이 정산된 시각입니다. 정산된 시장에만 값이 채워집니다."
    },
    "settlement_bounds_type": {
      "type": "string",
      "enum": [
        "default",
        "floor"
      ],
      "description": "이 시장에 적용되는 정산 경계입니다. default는 시장에 정산 경계가 없음을 의미합니다"
    },
    "settlement_floor_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    },
    "expiration_value": {
      "type": "string",
      "description": "정산에 고려된 값"
    },
    "occurrence_datetime": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "기초 이벤트가 발생한 기록된 날짜와 시각(사용 가능한 경우)"
    },
    "fee_waiver_expiration_time": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "x-omitempty": true,
      "description": "이 시장의 수수료 면제가 만료되는 시각"
    },
    "early_close_condition": {
      "type": [
        "string",
        "null"
      ],
      "x-omitempty": true,
      "description": "시장이 조기 종료될 수 있는 조건",
      "x-go-type-skip-optional-pointer": true
    },
    "strike_type": {
      "type": "string",
      "enum": [
        "greater",
        "greater_or_equal",
        "less",
        "less_or_equal",
        "between",
        "functional",
        "custom",
        "structured"
      ],
      "x-omitempty": true,
      "description": "행사가 유형은 시장 행사가가 어떻게 정의되고 평가되는지를 나타냅니다.",
      "x-go-type-skip-optional-pointer": true
    },
    "floor_strike": {
      "type": [
        "number",
        "null"
      ],
      "format": "double",
      "x-omitempty": true,
      "description": "YES 정산으로 이어지는 최소 만료 값"
    },
    "cap_strike": {
      "type": [
        "number",
        "null"
      ],
      "format": "double",
      "x-omitempty": true,
      "description": "YES 정산으로 이어지는 최대 만료 값"
    },
    "functional_strike": {
      "type": [
        "string",
        "null"
      ],
      "x-omitempty": true,
      "description": "만료 값에서 정산 값으로의 매핑"
    },
    "custom_strike": {
      "type": [
        "object",
        "null"
      ],
      "x-omitempty": true,
      "description": "YES 정산으로 이어지는 각 대상의 만료 값"
    },
    "rules_primary": {
      "type": "string",
      "description": "가장 중요한 시장 조건에 대한 쉬운 설명"
    },
    "rules_secondary": {
      "type": "string",
      "description": "2차 시장 조건에 대한 쉬운 설명"
    },
    "mve_collection_ticker": {
      "type": "string",
      "x-omitempty": true,
      "description": "다변량 이벤트 컬렉션의 티커",
      "x-go-type-skip-optional-pointer": true
    },
    "mve_selected_legs": {
      "type": "array",
      "x-omitempty": true,
      "items": {
        "$ref": "#/components/schemas/Response24B585A0A861_MveSelectedLeg"
      },
      "x-go-type-skip-optional-pointer": true
    },
    "primary_participant_key": {
      "type": [
        "string",
        "null"
      ],
      "x-omitempty": true
    },
    "price_level_structure": {
      "type": "string",
      "description": "이 시장의 가격 레벨 구조로, 가격 범위와 호가 단위를 정의합니다"
    },
    "price_ranges": {
      "type": "array",
      "description": "이 시장의 주문에 유효한 가격 범위",
      "items": {
        "$ref": "#/components/schemas/Response24B585A0A861_PriceRange"
      }
    },
    "is_provisional": {
      "type": "boolean",
      "x-omitempty": true,
      "description": "true이면 확정 후 시장에 활동이 없을 경우 해당 시장이 제거될 수 있습니다",
      "x-go-type-skip-optional-pointer": true
    },
    "exchange_index": {
      "allOf": [
        {
          "$ref": "#/components/schemas/Response24B585A0A861_ExchangeIndex"
        }
      ],
      "x-go-type-skip-optional-pointer": true,
      "x-omitempty": false
    }
  }
}
```

### Response24B585A0A861_MveSelectedLeg

`#/components/schemas/Response24B585A0A861_MveSelectedLeg`

```json
{
  "type": "object",
  "properties": {
    "event_ticker": {
      "type": "string",
      "description": "선택한 이벤트의 고유 식별자입니다.",
      "x-go-type-skip-optional-pointer": true
    },
    "market_ticker": {
      "type": "string",
      "description": "선택한 시장의 고유 식별자입니다.",
      "x-go-type-skip-optional-pointer": true
    },
    "side": {
      "type": "string",
      "description": "선택한 시장의 사이드입니다.",
      "x-go-type-skip-optional-pointer": true
    },
    "yes_settlement_value_dollars": {
      "$ref": "#/components/schemas/Response24B585A0A861_FixedPointDollars"
    }
  }
}
```

### Response24B585A0A861_PriceRange

`#/components/schemas/Response24B585A0A861_PriceRange`

```json
{
  "type": "object",
  "required": [
    "start",
    "end",
    "step"
  ],
  "properties": {
    "start": {
      "type": "string",
      "description": "이 범위의 시작 가격(달러)입니다."
    },
    "end": {
      "type": "string",
      "description": "이 범위의 종료 가격(달러)입니다."
    },
    "step": {
      "type": "string",
      "description": "이 범위의 가격 단위/틱 크기(달러)입니다."
    }
  }
}
```