API và Python SDK

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 Tải fileCSV/TXT tới 32 MB · 200.000 dòng

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.

Dán dữ liệuTham số JSON

Lấy từ internetdán đường dẫn trang hoặc file

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.

Tổng quan Bảng số liệu Công thức Hướng dẫn

Kết quả

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

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ểu	Bạn gửi	Giá trị dùng	Mặc định
p	number	có	0.62	0.6
b	number	có	2.5	2.0
fraction	number	có	0.25	0.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

Đ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.
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.
Đọc thẻ số ở trên cùng, rồi mục Diễn giải nhanh để biết con số đó nói gì.
Đọ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

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

! à

! n

! g

! đ

! ổ

! i

! m

! à

! h

! ọ

! k

! h

! ô

! n

! g

! b

! i

! ế

! t

! v

! ì

! s

! a

! o

! .

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

API và Python SDK là gì?

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.