v0.2.0-beta

OpenAPI 3.1.0

Lấy thị trường Kalshi

Felo API Support

MIT

Máy chủ

https://openapi.felo.ai

Thư viện client

Shell Curl

Kalshi

Prediction-market data.

Kalshi Thao tác

get/v1/beta/kalshi/markets

Lấy thị trường Kalshi

Liệt kê thị trường dự đoán bằng các bộ lọc status, ticker, event, series và timestamp được ghi trong tài liệu. Hợp đồng có bao gồm max_updated_ts nhưng không khai báo tham số tìm kiếm văn bản tự do. Xem schema phản hồi để biết bản ghi thị trường và phân trang.

Tham chiếu giá

Đo lường: Cơ sở chi phí cố định theo yêu cầu thành công.
Ước tính tham chiếu cho mỗi yêu cầu: USD 0.02.

Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.

Tham số truy vấn

cursor
Kiểu: string

Con trỏ phân trang. Dùng giá trị con trỏ được trả về từ phản hồi trước để lấy trang kết quả tiếp theo. Để trống cho trang đầu tiên.
event_ticker
Kiểu: string

Ticker sự kiện cần lọc. Chỉ hỗ trợ một ticker sự kiện duy nhất.
limit
Kiểu: integer Định dạng: int64
tối thiểu:
0
tối đa:
1000

Số kết quả mỗi trang. Mặc định là 100. Giá trị tối đa là 1000.
max_close_ts
Kiểu: integer Định dạng: int64

Lọc các mục đóng trước dấu thời gian Unix này
max_created_ts
Kiểu: integer Định dạng: int64

Lọc các mục được tạo trước dấu thời gian Unix này
max_settled_ts
Kiểu: integer Định dạng: int64

Lọc các mục được quyết toán trước dấu thời gian Unix này
max_updated_ts
Kiểu: integer Định dạng: int64

Trả về các thị trường có siêu dữ liệu được cập nhật tại hoặc trước dấu thời gian Unix này (tính bằng giây). Chỉ theo dõi các thay đổi không liên quan đến giao dịch. Có thể kết hợp với min_updated_ts và mve_filter=exclude. Cũng có thể kết hợp với series_ticker, yêu cầu mve_filter=exclude. Không tương thích với các bộ lọc khác.
min_close_ts
Kiểu: integer Định dạng: int64

Lọc các mục đóng sau dấu thời gian Unix này
min_created_ts
Kiểu: integer Định dạng: int64

Lọc các mục được tạo sau dấu thời gian Unix này
min_settled_ts
Kiểu: integer Định dạng: int64

Lọc các mục được quyết toán sau dấu thời gian Unix này
min_updated_ts
Kiểu: integer Định dạng: int64

Trả về các thị trường có siêu dữ liệu được cập nhật muộn hơn dấu thời gian Unix này (tính bằng giây). Chỉ theo dõi các thay đổi không liên quan đến giao dịch. Có thể kết hợp với max_updated_ts và mve_filter=exclude. Cũng có thể kết hợp với series_ticker, yêu cầu mve_filter=exclude. Không tương thích với các bộ lọc khác.
mve_filter
Kiểu: string enum

Lọc theo sự kiện đa biến (combo). 'only' chỉ trả về sự kiện đa biến, 'exclude' loại trừ sự kiện đa biến.
giá trị
- only
- exclude
series_ticker
Kiểu: string

Lọc theo ticker chuỗi
status
Kiểu: string enum

Lọc theo trạng thái thị trường. Để trống để trả về thị trường ở mọi trạng thái.
giá trị
- unopened
- open
- paused
- closed
- settled
tickers
Kiểu: string

Lọc theo các ticker thị trường cụ thể. Danh sách ticker thị trường được phân tách bằng dấu phẩy cần lấy.

Phản hồi

200
Kiểu: object · Response24B585A0A861_GetMarketsResponse

Truy xuất thị trường thành công
cursor
Kiểu: string
bắt buộc
markets
Kiểu: array object[] · Response24B585A0A861_Market[]
bắt buộc
can_close_early
Kiểu: boolean
bắt buộc
close_time
Kiểu: string Định dạng: date-time
bắt buộc

the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

created_time
Kiểu: string Định dạng: date-time
bắt buộc

the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

event_ticker
Kiểu: string
bắt buộc
expiration_value
Kiểu: string
bắt buộc

Giá trị đã được xem xét cho việc quyết toán

last_price_dollars
Kiểu: string · Response24B585A0A861_FixedPointDollars
bắt buộc

Chuỗi đô la Mỹ dấu phẩy tĩnh. Hầu hết trường yêu cầu chấp nhận 2-4 chữ số thập phân (ví dụ "0.56", "0.5600"); phản hồi xuất tối đa 6. Các khoảng báo giá hợp lệ cho một thị trường nhất định bị ràng buộc bởi cấu trúc mức giá của thị trường đó.

latest_expiration_time
Kiểu: string Định dạng: date-time
bắt buộc

Thời điểm muộn nhất có thể để thị trường này hết hạn

market_type
Kiểu: string enum
bắt buộc

Xác định loại thị trường

giá trị
binary
scalar
no_ask_dollars
Kiểu: string · Response24B585A0A861_FixedPointDollars
bắt buộc

Chuỗi đô la Mỹ dấu phẩy tĩnh. Hầu hết trường yêu cầu chấp nhận 2-4 chữ số thập phân (ví dụ "0.56", "0.5600"); phản hồi xuất tối đa 6. Các khoảng báo giá hợp lệ cho một thị trường nhất định bị ràng buộc bởi cấu trúc mức giá của thị trường đó.

no_bid_dollars
Kiểu: string · Response24B585A0A861_FixedPointDollars
bắt buộc

Chuỗi đô la Mỹ dấu phẩy tĩnh. Hầu hết trường yêu cầu chấp nhận 2-4 chữ số thập phân (ví dụ "0.56", "0.5600"); phản hồi xuất tối đa 6. Các khoảng báo giá hợp lệ cho một thị trường nhất định bị ràng buộc bởi cấu trúc mức giá của thị trường đó.

no_sub_title
Kiểu: string
bắt buộc

Tiêu đề rút gọn cho phía NO của thị trường này

notional_value_dollars
Kiểu: string · Response24B585A0A861_FixedPointDollars
bắt buộc

Chuỗi đô la Mỹ dấu phẩy tĩnh. Hầu hết trường yêu cầu chấp nhận 2-4 chữ số thập phân (ví dụ "0.56", "0.5600"); phản hồi xuất tối đa 6. Các khoảng báo giá hợp lệ cho một thị trường nhất định bị ràng buộc bởi cấu trúc mức giá của thị trường đó.

open_interest_fp
Kiểu: string · Response24B585A0A861_FixedPointCount
bắt buộc

Chuỗi số lượng hợp đồng dấu phẩy tĩnh (2 chữ số thập phân, ví dụ "10.00"; được gọi là "fp" trong tên trường). Yêu cầu chấp nhận 0-2 chữ số thập phân (ví dụ "10", "10.0", "10.00"); phản hồi luôn xuất 2 chữ số thập phân. Hỗ trợ giá trị hợp đồng lẻ (ví dụ "2.50"); độ chi tiết tối thiểu là 0.01 hợp đồng.

open_time
Kiểu: string Định dạng: date-time
bắt buộc

the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

previous_price_dollars
Kiểu: string · Response24B585A0A861_FixedPointDollars
bắt buộc

Chuỗi đô la Mỹ dấu phẩy tĩnh. Hầu hết trường yêu cầu chấp nhận 2-4 chữ số thập phân (ví dụ "0.56", "0.5600"); phản hồi xuất tối đa 6. Các khoảng báo giá hợp lệ cho một thị trường nhất định bị ràng buộc bởi cấu trúc mức giá của thị trường đó.

previous_yes_ask_dollars
Kiểu: string · Response24B585A0A861_FixedPointDollars
bắt buộc

Chuỗi đô la Mỹ dấu phẩy tĩnh. Hầu hết trường yêu cầu chấp nhận 2-4 chữ số thập phân (ví dụ "0.56", "0.5600"); phản hồi xuất tối đa 6. Các khoảng báo giá hợp lệ cho một thị trường nhất định bị ràng buộc bởi cấu trúc mức giá của thị trường đó.

previous_yes_bid_dollars
Kiểu: string · Response24B585A0A861_FixedPointDollars
bắt buộc

Chuỗi đô la Mỹ dấu phẩy tĩnh. Hầu hết trường yêu cầu chấp nhận 2-4 chữ số thập phân (ví dụ "0.56", "0.5600"); phản hồi xuất tối đa 6. Các khoảng báo giá hợp lệ cho một thị trường nhất định bị ràng buộc bởi cấu trúc mức giá của thị trường đó.

price_level_structure
Kiểu: string
bắt buộc

Cấu trúc mức giá cho thị trường này, xác định phạm vi giá và bước giá

price_ranges
Kiểu: array object[] · Response24B585A0A861_PriceRange[]
bắt buộc

Phạm vi giá hợp lệ cho các lệnh trên thị trường này

end
Kiểu: string
bắt buộc

Giá kết thúc của khoảng này tính bằng đô la

start
Kiểu: string
bắt buộc

Giá bắt đầu của khoảng này tính bằng đô la

step
Kiểu: string
bắt buộc

Bước giá/kích thước tick của khoảng này tính bằng đô la

result
Kiểu: string enum
bắt buộc
giá trị
yes
no
scalar
rules_primary
Kiểu: string
bắt buộc

Mô tả bằng ngôn ngữ đơn giản về các điều khoản thị trường quan trọng nhất

rules_secondary
Kiểu: string
bắt buộc

Mô tả bằng ngôn ngữ đơn giản về các điều khoản thị trường thứ cấp

settlement_bounds_type
Kiểu: string enum
bắt buộc

Giới hạn quyết toán nào áp dụng cho thị trường này. default nghĩa là thị trường không có giới hạn quyết toán

giá trị
default
floor
settlement_timer_seconds
Kiểu: integer
bắt buộc

Khoảng thời gian sau khi xác định kết quả để thị trường thanh toán

status
Kiểu: string enum
bắt buộc

Trạng thái hiện tại của thị trường trong vòng đời của nó.

giá trị
initialized
inactive
active
closed
determined
disputed
amended
finalized
ticker
Kiểu: string
bắt buộc
updated_time
Kiểu: string Định dạng: date-time
bắt buộc

Thời điểm cập nhật siêu dữ liệu không phải giao dịch gần nhất.

volume_24h_fp
Kiểu: string · Response24B585A0A861_FixedPointCount
bắt buộc

Chuỗi số lượng hợp đồng dấu phẩy tĩnh (2 chữ số thập phân, ví dụ "10.00"; được gọi là "fp" trong tên trường). Yêu cầu chấp nhận 0-2 chữ số thập phân (ví dụ "10", "10.0", "10.00"); phản hồi luôn xuất 2 chữ số thập phân. Hỗ trợ giá trị hợp đồng lẻ (ví dụ "2.50"); độ chi tiết tối thiểu là 0.01 hợp đồng.

volume_fp
Kiểu: string · Response24B585A0A861_FixedPointCount
bắt buộc

Chuỗi số lượng hợp đồng dấu phẩy tĩnh (2 chữ số thập phân, ví dụ "10.00"; được gọi là "fp" trong tên trường). Yêu cầu chấp nhận 0-2 chữ số thập phân (ví dụ "10", "10.0", "10.00"); phản hồi luôn xuất 2 chữ số thập phân. Hỗ trợ giá trị hợp đồng lẻ (ví dụ "2.50"); độ chi tiết tối thiểu là 0.01 hợp đồng.

yes_ask_dollars
Kiểu: string · Response24B585A0A861_FixedPointDollars
bắt buộc

Chuỗi đô la Mỹ dấu phẩy tĩnh. Hầu hết trường yêu cầu chấp nhận 2-4 chữ số thập phân (ví dụ "0.56", "0.5600"); phản hồi xuất tối đa 6. Các khoảng báo giá hợp lệ cho một thị trường nhất định bị ràng buộc bởi cấu trúc mức giá của thị trường đó.

yes_ask_size_fp
Kiểu: string · Response24B585A0A861_FixedPointCount
bắt buộc

Chuỗi số lượng hợp đồng dấu phẩy tĩnh (2 chữ số thập phân, ví dụ "10.00"; được gọi là "fp" trong tên trường). Yêu cầu chấp nhận 0-2 chữ số thập phân (ví dụ "10", "10.0", "10.00"); phản hồi luôn xuất 2 chữ số thập phân. Hỗ trợ giá trị hợp đồng lẻ (ví dụ "2.50"); độ chi tiết tối thiểu là 0.01 hợp đồng.

yes_bid_dollars
Kiểu: string · Response24B585A0A861_FixedPointDollars
bắt buộc

Chuỗi đô la Mỹ dấu phẩy tĩnh. Hầu hết trường yêu cầu chấp nhận 2-4 chữ số thập phân (ví dụ "0.56", "0.5600"); phản hồi xuất tối đa 6. Các khoảng báo giá hợp lệ cho một thị trường nhất định bị ràng buộc bởi cấu trúc mức giá của thị trường đó.

yes_bid_size_fp
Kiểu: string · Response24B585A0A861_FixedPointCount
bắt buộc

Chuỗi số lượng hợp đồng dấu phẩy tĩnh (2 chữ số thập phân, ví dụ "10.00"; được gọi là "fp" trong tên trường). Yêu cầu chấp nhận 0-2 chữ số thập phân (ví dụ "10", "10.0", "10.00"); phản hồi luôn xuất 2 chữ số thập phân. Hỗ trợ giá trị hợp đồng lẻ (ví dụ "2.50"); độ chi tiết tối thiểu là 0.01 hợp đồng.

yes_sub_title
Kiểu: string
bắt buộc

Tiêu đề rút gọn cho phía Có của thị trường này

cap_strike
Kiểu: number | null Định dạng: double

Giá trị hết hạn tối đa dẫn đến quyết toán YES

custom_strike
Kiểu: object | null

Giá trị hết hạn cho mỗi mục tiêu dẫn đến quyết toán YES

early_close_condition
Kiểu: string | null

Điều kiện để thị trường có thể đóng sớm

exchange_index
Kiểu: integer · Response24B585A0A861_ExchangeIndex

Mã định danh cho một phân mảnh sàn giao dịch.

expected_expiration_time
Kiểu: string | null Định dạng: date-time

Thời điểm thị trường này dự kiến hết hạn

expiration_time
Kiểu: string Định dạng: date-time
không còn được dùng

the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

fee_waiver_expiration_time
Kiểu: string | null Định dạng: date-time

Thời điểm miễn phí giao dịch của thị trường này hết hạn

floor_strike
Kiểu: number | null Định dạng: double

Giá trị hết hạn tối thiểu dẫn đến quyết toán YES

functional_strike
Kiểu: string | null

Ánh xạ từ giá trị hết hạn sang giá trị quyết toán

is_provisional
Kiểu: boolean

Nếu là true, thị trường có thể bị xóa sau khi xác định nếu không có hoạt động nào trên đó

mve_collection_ticker
Kiểu: string

Ticker của bộ sưu tập sự kiện đa biến

mve_selected_legs
Kiểu: array object[] · Response24B585A0A861_MveSelectedLeg[]
event_ticker
Kiểu: string

Mã định danh duy nhất cho sự kiện đã chọn

market_ticker
Kiểu: string

Mã định danh duy nhất cho thị trường đã chọn

side
Kiểu: string

Phía của thị trường đã chọn

yes_settlement_value_dollars
Kiểu: string · Response24B585A0A861_FixedPointDollars

Chuỗi đô la Mỹ dấu phẩy tĩnh. Hầu hết trường yêu cầu chấp nhận 2-4 chữ số thập phân (ví dụ "0.56", "0.5600"); phản hồi xuất tối đa 6. Các khoảng báo giá hợp lệ cho một thị trường nhất định bị ràng buộc bởi cấu trúc mức giá của thị trường đó.

occurrence_datetime
Kiểu: string | null Định dạng: date-time

Ngày giờ được ghi nhận khi sự kiện cơ sở xảy ra, nếu có

primary_participant_key
Kiểu: string | null
settlement_floor_dollars
Kiểu: string · Response24B585A0A861_FixedPointDollars

Chuỗi đô la Mỹ dấu phẩy tĩnh. Hầu hết trường yêu cầu chấp nhận 2-4 chữ số thập phân (ví dụ "0.56", "0.5600"); phản hồi xuất tối đa 6. Các khoảng báo giá hợp lệ cho một thị trường nhất định bị ràng buộc bởi cấu trúc mức giá của thị trường đó.

settlement_ts
Kiểu: string | null Định dạng: date-time

Dấu thời gian khi thị trường được thanh toán. Chỉ được điền cho các thị trường đã thanh toán

settlement_value_dollars
Kiểu: string · Response24B585A0A861_FixedPointDollars

Chuỗi đô la Mỹ dấu phẩy tĩnh. Hầu hết trường yêu cầu chấp nhận 2-4 chữ số thập phân (ví dụ "0.56", "0.5600"); phản hồi xuất tối đa 6. Các khoảng báo giá hợp lệ cho một thị trường nhất định bị ràng buộc bởi cấu trúc mức giá của thị trường đó.

strike_type
Kiểu: string enum

Loại giá thực hiện xác định cách giá thực hiện của thị trường được định nghĩa và đánh giá

giá trị
greater
greater_or_equal
less
less_or_equal
between
functional
custom
structured
subtitle
Kiểu: string
không còn được dùng
title
Kiểu: string
không còn được dùng
application/json
400

Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.
401

Cần có khóa API Felo hợp lệ.
402

Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.
403

Tài khoản không được phép thực hiện thao tác này.
429

Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.
502

Dịch vụ không thể hoàn tất yêu cầu.
503

API hoặc dịch vụ thanh toán tạm thời không khả dụng.
504

Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.
default

Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp

application/json

get/v1/beta/kalshi/markets

curl https://openapi.felo.ai/v1/beta/kalshi/markets \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Hiện schema

{
  "markets": [
    {
      "ticker": "string",
      "event_ticker": "string",
      "market_type": "binary",
      "yes_sub_title": "string",
      "no_sub_title": "string",
      "created_time": "2026-10-26T08:08:16.607Z",
      "updated_time": "2026-10-26T08:08:16.607Z",
      "open_time": "2026-10-26T08:08:16.607Z",
      "close_time": "2026-10-26T08:08:16.607Z",
      "expected_expiration_time": null,
      "latest_expiration_time": "2026-10-26T08:08:16.607Z",
      "settlement_timer_seconds": 1,
      "status": "initialized",
      "yes_bid_dollars": "0.5600",
      "yes_bid_size_fp": "10.00",
      "yes_ask_dollars": "0.5600",
      "yes_ask_size_fp": "10.00",
      "no_bid_dollars": "0.5600",
      "no_ask_dollars": "0.5600",
      "last_price_dollars": "0.5600",
      "volume_fp": "10.00",
      "volume_24h_fp": "10.00",
      "result": "yes",
      "can_close_early": true,
      "open_interest_fp": "10.00",
      "notional_value_dollars": "0.5600",
      "previous_yes_bid_dollars": "0.5600",
      "previous_yes_ask_dollars": "0.5600",
      "previous_price_dollars": "0.5600",
      "settlement_value_dollars": "0.5600",
      "settlement_ts": null,
      "settlement_bounds_type": "default",
      "settlement_floor_dollars": "0.5600",
      "expiration_value": "string",
      "occurrence_datetime": null,
      "fee_waiver_expiration_time": null,
      "early_close_condition": null,
      "strike_type": "greater",
      "floor_strike": null,
      "cap_strike": null,
      "functional_strike": null,
      "custom_strike": null,
      "rules_primary": "string",
      "rules_secondary": "string",
      "mve_collection_ticker": "string",
      "mve_selected_legs": [
        {
          "event_ticker": "string",
          "market_ticker": "string",
          "side": "string",
          "yes_settlement_value_dollars": "0.5600"
        }
      ],
      "primary_participant_key": null,
      "price_level_structure": "string",
      "price_ranges": [
        {
          "start": "string",
          "end": "string",
          "step": "string"
        }
      ],
      "is_provisional": true,
      "exchange_index": 0
    }
  ],
  "cursor": "string"
}

Truy xuất thị trường thành công

Lấy thị trường Kalshi

Xác thựcRequired

Kalshi

Lấy thị trường Kalshi

Tham chiếu giá