Kalshi
Prediction-market data.
Lấy giao dịch Kalshi
Lấy danh sách giao dịch đã thực hiện của thị trường Kalshi — các lần khớp lệnh thực tế, không phải báo giá. Dùng khi cần giá đã thực hiện và khối lượng giao dịch trong một khoảng thời gian, ví dụ để xem mức độ tin tưởng đã thay đổi thế nào khi một sự kiện diễn ra; thu hẹp bằng ticker và khoảng giây Unix min_ts / max_ts, đặt is_block_trade để tách các giao dịch lớn đã thương lượng. Trả về trades[] với trade_id, ticker, count_fp (hợp đồng), yes_price_dollars / no_price_dollars, taker_side và created_time, kèm cursor để phân trang. Để lấy báo giá hiện tại, quy tắc thanh toán và siêu dữ liệu thị trường thay vì các lần khớp lệnh, dùng get_kalshi_markets.
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.
- Kiểu: stringcursor
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.
- Kiểu: booleanis
_block _trade Lọc giao dịch theo việc chúng có phải giao dịch khối hay không. Bỏ trống để trả về tất cả giao dịch. Đặt thành
trueđể chỉ trả về giao dịch khối. Đặt thànhfalseđể chỉ trả về giao dịch không phải khối. - Kiểu: integer Định dạng: int64limittối thiểu:0tối đa:1000
Số kết quả mỗi trang. Mặc định là 100. Giá trị tối đa là 1000.
- Kiểu: integer Định dạng: int64max
_ts Lọc các mục trước dấu thời gian Unix này
- Kiểu: integer Định dạng: int64min
_ts Lọc các mục sau dấu thời gian Unix này
- Kiểu: stringticker
Lọc theo ticker thị trường
- Kiểu: object · Response24B585A0A861_GetTradesResponse200
Truy xuất giao dịch thành công
- Kiểu: stringcursorbắt buộc
- Kiểu: array object[] · Response24B585A0A861_Trade[]tradesbắt buộc
- countKiểu: string · Response24B585A0A861_FixedPointCount
_fp bắt buộcChuỗ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.
- createdKiểu: string Định dạng: date-time
_time bắt buộcDấu thời gian khi giao dịch này được thực hiện
- isKiểu: boolean
_block _trade bắt buộcTrue nếu giao dịch này được khớp ngoài sổ lệnh dưới dạng giao dịch khối (ví dụ: qua RFQ / đề xuất giao dịch khối thương lượng); false đối với các giao dịch được khớp trên sổ lệnh tiêu chuẩn.
- noKiểu: string · Response24B585A0A861_FixedPointDollars
_price _dollars bắt buộcChuỗ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 đó.
- takerKiểu: string · Response24B585A0A861_BookSideenum
_book _side bắt buộcPhía của sổ lệnh cho một lệnh hoặc giao dịch. Với thị trường sự kiện, điều này chỉ đề cập đến chân YES:
bidnghĩa là mua YES,asknghĩa là bán YES. (Bán YES tương đương về mặt kinh tế với mua NO ở1 - price, nhưng endpoint này báo giá mọi thứ từ phía YES.)giá trị- bid
- ask
- takerKiểu: string enum
_outcome _side bắt buộcPhía kết quả mà taker hướng tới. buy-yes và sell-no tạo ra 'yes'; buy-no và sell-yes tạo ra 'no'.
taker_outcome_sidechỉ mô tả mức tiếp xúc theo hướng; nó không làm thay đổi giá của giao dịch. Giao dịch ở giápvớitaker_outcome_side=nođược khớp với maker ở cùng giáptheo hướng ngược lại — cả hai bên giao dịch ở cùng một mức giá.taker_outcome_sidevàtaker_book_sidesẽ trở thành cách chuẩn để xác định hướng giao dịch. Trường cũtaker_sidesẽ bị ngừng hỗ trợ trong một bản phát hành tương lai — vui lòng chuyển sang các trường mới này.giá trị- yes =
Trade Taker Outcome Side Yes - no =
Trade Taker Outcome Side No
- tickerKiểu: stringbắt buộc
Mã định danh duy nhất cho thị trường
- tradeKiểu: string
_id bắt buộcMã định danh duy nhất cho giao dịch này
- yesKiểu: string · Response24B585A0A861_FixedPointDollars
_price _dollars bắt buộcChuỗ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 đó.
- takerKiểu: string enum
_side không còn được dùngKhông dùng nữa. Hãy dùng
taker_outcome_side(hoặctaker_book_side) thay thế. Xem Hướng lệnh. Trường này sẽ không bị xóa trước ngày 14 tháng 5 năm 2026.giá trị- yes =
Trade Taker Side Yes - no =
Trade Taker Side No
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
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.678Z",
"is_block_trade": true
}
],
"cursor": "string"
}