Trading & Investment hoạt động

API và Python SDK

API — REST + Python SDK

Đã chạy được. Mục này có công cụ tính toán thật trên nền tảng, không phải mô tả lộ trình.

Gọi thử API Chạy bất kỳ công cụ nào qua hợp đồng JSON

Bộ thử API chạy thật: nó gọi đúng registry và đúng hàm mà endpoint HTTP gọi, nên phản hồi JSON bạn thấy ở đây chính là phản hồi bạn nhận khi tích hợp. Đổi mã công cụ để thử bất kỳ công cụ nào trên nền tảng.

Hướng dẫn Công thức API
Đang chạy trên dữ liệu mẫu, không phải dữ liệu của bạn. Các ô còn nguyên mẫu dựng sẵn: Tham số JSON. Chọn nguồn dữ liệu khác ở cột bên trái rồi chạy lại để có kết quả của riêng bạn.
Công cụ Công thức Kelly
Trạng thái 200 OK
Số trường trả về 3
Tham số lạ bị bỏ qua 0
Kết luận 200 OK
① Nguồn dữ liệu

Nhận dấu phẩy, chấm phẩy hoặc tab; tự nhận dòng tiêu đề; hiểu cả 1.234.567 lẫn 1.234,56.

Chỉ tải http/https tới địa chỉ công khai; địa chỉ nội bộ bị từ chối.

Giá trị mặc định là ví dụ chạy được — bấm Tính ngay để xem kết quả, rồi thay dữ liệu của bạn vào.

Kết quả

Công cụCông thức Kelly
Trạng thái200 OK
Số trường trả về3
Tham số lạ bị bỏ qua0

Diễn giải nhanh

0 tham số lạ bị bỏ qua

Endpoint KHÔNG báo lỗi khi bạn gửi sai tên khoá — nó im lặng bỏ qua và chạy bằng giá trị mặc định. Gõ nhầm một tên tham số vì thế vẫn trả về 200 OK, chỉ là trả về đáp án cho câu hỏi khác.

3/3 tham số do bạn gửi, 0 chạy bằng mặc định

Bạn đã gửi đủ mọi tham số, nên không có giá trị ngầm định nào chen vào kết quả.

Phản hồi 474 ký tự · 3 trường values · 2 dòng detail

Giá trị trong `values` là CHUỖI đã định dạng sẵn — có dấu ngăn nghìn, dấu %, đơn vị — chứ không phải số thô. Bên tích hợp phải tự bóc tách nếu muốn tính tiếp trên chúng.

5 phần kết quả bị bỏ lại ngoài JSON: 1 biểu đồ, 3 dòng diễn giải, 1 kết luận

Hợp đồng JSON chỉ có `values`, `caveat` và `detail`. Phần còn lại công cụ vẫn tính nhưng chỉ tồn tại trên trang web, nên giao diện dựng lại từ endpoint này sẽ nghèo hơn bản gốc. `caveat` thì LUÔN đi kèm — đó là điều kiện khiến con số sai, và tích hợp nào hiển thị `values` mà bỏ `caveat` là đã bỏ đi phần duy nhất nói cho người dùng biết khi nào đừng tin kết quả.

Khi nào con số này sai: API dùng CHUNG hàm với giao diện web, nên kết quả không thể lệch nhau. Nhưng phiên bản mô hình có thể đổi giữa các lần deploy — hãy ghim phiên bản trong tích hợp của bạn thay vì giả định kết quả bất biến.

Chi tiết

Endpoint POST /api/v1/tools/kelly-sizing
Content-Type application/json
Tham số hợp lệ p (number), b (number), fraction (number)
Tham số lạ không có
Ví dụ curl 
curl -X POST /api/v1/tools/kelly-sizing \
  -H 'Content-Type: application/json' \
  -d '{"p": 0.6, "b": 2.0, "fraction": 0.25}'
Phản hồi JSON 
{
  "tool": "kelly-sizing",
  "ok": true,
  "values": {
    "Kelly đầy đủ": "46.80%",
    "Kelly × 0.25": "11.70%",
    "Kỳ vọng mỗi cược": "+1.1700"
  },
  "caveat": "Kelly đầy đủ giả định xác suất thắng là chính xác. Ước lượng cao hơn thực tế vài phần trăm là đủ để Kelly đầy đủ thành quá liều.",
  "detail": [
    {
      "label": "Công thức",
      "value": "f* = p − (1−p)/b"
    },
    {
      "label": "Diễn giải",
      "value": "Đặt 11.70% vốn mỗi lệnh"
    }
  ]
}

Hợp đồng tham số của công cụ này

Tham sốKiểuBạn gửiGiá trị dùngMặc định
pnumbercó0.620.6
bnumbercó2.52.0
fractionnumbercó0.250.25

Toàn bộ chỉ số

Endpoint POST /api/v1/tools/kelly-sizing
Content-Type application/json
Tham số hợp lệ p (number), b (number), fraction (number)
Tham số lạ không có
Ví dụ curl 
curl -X POST /api/v1/tools/kelly-sizing \
  -H 'Content-Type: application/json' \
  -d '{"p": 0.6, "b": 2.0, "fraction": 0.25}'
Phản hồi JSON 
{
  "tool": "kelly-sizing",
  "ok": true,
  "values": {
    "Kelly đầy đủ": "46.80%",
    "Kelly × 0.25": "11.70%",
    "Kỳ vọng mỗi cược": "+1.1700"
  },
  "caveat": "Kelly đầy đủ giả định xác suất thắng là chính xác. Ước lượng cao hơn thực tế vài phần trăm là đủ để Kelly đầy đủ thành quá liều.",
  "detail": [
    {
      "label": "Công thức",
      "value": "f* = p − (1−p)/b"
    },
    {
      "label": "Diễn giải",
      "value": "Đặt 11.70% vốn mỗi lệnh"
    }
  ]
}

Công thức đang dùng

POST /api/v1/tools/<slug> · Content-Type: application/json

Đây là công thức thật mà mã nguồn chạy, không phải mô tả gần đúng. API tại /api/v1/tools/api-call gọi đúng hàm này, nên kết quả trên trang và qua API không thể lệch nhau.

Cách dùng

  1. Điền tham số ở cột trái. Mọi ô đã có sẵn giá trị ví dụ chạy được, nên bạn có thể bấm Tính ngay trước rồi sửa sau.
  2. Với ô dữ liệu: dán vài chục dòng để thử, hoặc tải file CSV/TXT lên để chạy thật. File tối đa 32 MB, 200.000 dòng; bộ đọc nhận dấu phẩy, chấm phẩy hoặc tab, tự nhận dòng tiêu đề, và hiểu cả 1.234.567 lẫn 1.234,56.
  3. Đọc thẻ số ở trên cùng, rồi mục Diễn giải nhanh để biết con số đó nói gì.
  4. Đọc dòng “Khi nào con số này sai” trước khi dùng kết quả để quyết định — đó là giả định vỡ đầu tiên.
Giới hạn chung. Công cụ này tính đúng công thức của nó trên dữ liệu bạn đưa vào. Nó không kiểm tra dữ liệu của bạn có phù hợp với giả định của phương pháp hay không — phần đó vẫn là việc của người dùng, và mục “sai ở đâu” bên dưới trang liệt kê các chỗ hỏng thường gặp.

API và Python SDK là gì

API cho phép hệ thống khác gọi vào nền tảng thay vì người dùng thao tác thủ công. Với công cụ phân tích, yêu cầu quan trọng nhất không phải tốc độ mà là tính tái lập: cùng đầu vào và cùng phiên bản phải cho cùng kết quả.

Làm thế nào

  1. Đặt phiên bản trong đường dẫn để thay đổi không phá vỡ tích hợp đang chạy.
  2. Trả về mã lỗi rõ ràng kèm thông điệp hành động được.
  3. Giới hạn tần suất gọi và ghi log đầy đủ.
  4. Ghi rõ phiên bản mô hình trong mỗi phản hồi.

Đo bằng chỉ số nào

Độ trễ p95 đuôi quan trọng hơn trung bình
Tỷ lệ lỗi theo từng endpoint
Tính tái lập cùng đầu vào cho cùng đầu ra

Sai ở đâu

Phần quan trọng nhất của trang này. Một phương pháp được mô tả mà không nói chỗ nó hỏng là phiên bản quảng cáo của phương pháp đó.

! T
! h
! a
! y
!
! đ
! ổ
! i
!
! m
! ô
!
! h
! ì
! n
! h
!
! p
! h
! í
! a
!
! s
! a
! u
!
! m
! à
!
! k
! h
! ô
! n
! g
!
! đ
! ổ
! i
!
! p
! h
! i
! ê
! n
!
! b
! ả
! n
!
! A
! P
! I
!
! k
! h
! i
! ế
! n
!
! k
! ế
! t
!
! q
! u
! ả
!
! c
! ủ
! a
!
! k
! h
! á
! c
! h
!
! h
! à
! n
! g
!
! đ
! ổ
! i
!
! m
! à
!
! h
! ọ
!
! k
! h
! ô
! n
! g
!
! b
! i
! ế
! t
!
! v
! ì
!
! s
! a
! o
! .

Mô hình định lượng dùng trong Trading

Chưa có mô hình nào gắn riêng cho chủ đề này. Đây là những mô hình của cả ngành — liên quan ở cấp ngành, không phải cấp chủ đề.

Tất cả mô hình →
Bayesian Inferencebeta

Cập nhật niềm tin khi có dữ liệu mới.
Monte Carlohoạt động

Lấy mẫu ngẫu nhiên để ước lượng phân phối kết quả.
Markov Chainsắp có

Trạng thái kế tiếp chỉ phụ thuộc trạng thái hiện tại.
Hidden Markov Modelsắp có

Suy ra trạng thái ẩn từ quan sát.

Câu hỏi thường gặp

API và Python SDK là gì?

API cho phép hệ thống khác gọi vào nền tảng thay vì người dùng thao tác thủ công. Với công cụ phân tích, yêu cầu quan trọng nhất không phải tốc độ mà là tính tái lập: cùng đầu vào và cùng phiên bản phải cho cùng kết quả.

API và Python SDK được làm như thế nào?

1. Đặt phiên bản trong đường dẫn để thay đổi không phá vỡ tích hợp đang chạy. 2. Trả về mã lỗi rõ ràng kèm thông điệp hành động được. 3. Giới hạn tần suất gọi và ghi log đầy đủ. 4. Ghi rõ phiên bản mô hình trong mỗi phản hồi.

API và Python SDK hay sai ở đâu?

T h a y đ ổ i m ô h ì n h p h í a s a u m à k h ô n g đ ổ i p h i ê n b ả n A P I k h i ế n k ế t q u ả c ủ a k h á c h h à n g đ ổ i m à h ọ k h ô n g b i ế t v ì s a o .

Đo api và python sdk bằng chỉ số nào?

Độ trễ p95 — đuôi quan trọng hơn trung bình; Tỷ lệ lỗi — theo từng endpoint; Tính tái lập — cùng đầu vào cho cùng đầu ra.

API và Python SDK trên QuantHub đã dùng được chưa?

Chưa xây dựng. Mục này hiện là điều hướng và tài liệu tham chiếu; chúng tôi không gắn nhãn 'live' cho thứ chưa chạy.

Chủ đề khác trong Trading

Toàn bộ Trading
Overview Market Analysis Trading Tools Risk Pricing Models Reports Documentation