Bitsgap API: Vận hành thuật toán giao dịch của bạn trên 17 sàn giao dịch

Việc thiết lập tự động hóa giao dịch cho riêng bạn trước đây đồng nghĩa với cả tuần làm việc. Đọc tài liệu API của một sàn, triển khai cơ chế ký của họ, xử lý các điểm đặc thù, rồi lặp lại quy trình này cho sàn tiếp theo. Thêm máy chủ, thêm logic tự động kết nối lại, thêm cách kiểm thử mà không bị mất tiền.

API của Bitsgap loại bỏ tuần đó. Một cặp khóa duy nhất hỗ trợ 17 sàn giao dịch, các sàn giao dịch demo đã có sẵn, và kết nối với sàn của bạn chính là kết nối mà các bot của bạn đang sử dụng. Trên các tài khoản đã thiết lập, thời gian trung vị từ lúc tạo khóa đến khi gửi thành công yêu cầu ký đầu tiên là 13 phút. API được bao gồm Free trong mọi gói, kể cả gói Free.

API giao dịch thực chất là gì

API là một danh sách cố định các lệnh mà một chương trình có thể gửi đến chương trình khác. API giao dịch chính là danh sách đó dành cho Market: đọc Giá, đọc Số dư, đặt Lệnh, hủy Lệnh, đóng Vị thế. Chương trình của bạn gửi một lệnh, máy chủ thực hiện công việc và gửi lại phản hồi. Mọi thao tác bạn có thể thực hiện bằng cách nhấp chuột trong Bitsgap, mã của bạn cũng có thể tự động thực hiện theo lịch trình riêng.

Phiên bản của Bitsgap được xây dựng xoay quanh một ý tưởng gọi là chủ đề — một đối tượng được đặt tên mà bạn muốn. price, balance, orders, order_place. Bạn đặt tên cho chủ đề, truyền các tham số của nó và nhận lại hoặc một ảnh chụp nhanh hoặc một luồng cập nhật trực tiếp.

json

{"topic": "price", "params": {"em": 101, "pair": "BTC_USDT"}}

Phần còn lại của giao thức là xác định những chủ đề nào tồn tại và mỗi chủ đề nhận những tham số nào. Không có endpoint riêng cho từng hành động và cũng không có định dạng thứ hai cần phải học khi bạn đi sâu hơn.

Tại sao không giao dịch trực tiếp trên sàn?

Bạn hoàn toàn có thể làm vậy, và đối với một sàn giao dịch duy nhất thì đó là lựa chọn hợp lý. Tuy nhiên, khi số lượng vượt quá một, sẽ có ba điều thay đổi.

Mỗi sàn giao dịch đều có phương thức ký riêng, vì vậy thêm một sàn mới đồng nghĩa với việc phải xây dựng lại toàn bộ từ đầu. Mỗi sàn đều cần một khóa riêng, được lưu trữ và luân chuyển tách biệt. Và hầu hết các sàn đều không cung cấp môi trường kiểm thử thực tế, nên mã mới sẽ tiếp xúc trực tiếp với tiền thật ngay từ lần chạy đầu tiên.

Thông qua Bitsgap, bạn chỉ cần một cặp khóa, một phương thức ký và một môi trường demo hoạt động giống hệt như môi trường thực tế. Thuật toán của bạn cũng nằm trong cùng Tài khoản với các bot GRID, DCA và COMBO, vì vậy tất cả vị thế của bạn sẽ hiển thị tập trung tại một nơi thay vì bị chia đôi giữa hai hệ thống khác nhau.

Mười ba phút, từng bước một

1. Tạo Tài khoản. Gói Free, không cần thẻ. API được bao gồm trong mọi gói, nên bạn không cần nâng cấp gì ở bước này.

2. Tạo khóa. Menu Tài khoản → API keys → Tạo khóa mới. Đặt tên và thời hạn cho khóa, sau đó nhấn Tạo. Thời hạn mặc định là ba năm.

3. Lưu khóa riêng tư. Khóa này chỉ xuất hiện một lần, dưới dạng tệp PEM. Hãy tải về và lưu trữ giống như cách bạn lưu trữ khóa sàn giao dịch. Nếu bị mất, khóa này không thể khôi phục mà chỉ có thể thay thế.

4. Kiểm tra việc ký của bạn hoạt động ngoại tuyến. Các ví dụ chính thức bao gồm một bài kiểm tra signing_offline không cần khóa và không cần mạng. Hãy chạy nó trước tiên. Phần lớn các vấn đề tích hợp đều liên quan đến chữ ký, và bước này sẽ phát hiện ra chúng trước khi có bất kỳ yếu tố nào khác cản trở.

5. Chạy hướng dẫn trên tài khoản demo. Các ví dụ được cung cấp cho Go, Rust, Python và TypeScript, mặc định sử dụng các sàn demo. Chỉ với một lệnh, bạn sẽ được trải nghiệm toàn bộ quy trình kết nối, dữ liệu Market, số dư, một lệnh Giao dịch, một lệnh Hợp đồng tương lai và lịch sử Lệnh. Không có bất kỳ khoản tiền thật nào được sử dụng trong suốt quá trình này.

6. Kết nối với sàn giao dịch thực. Chỉ cần thay đổi một con số — mã em của sàn giao dịch — và đoạn mã này sẽ chạy trực tiếp.

Cách thiết lập mà không cần tự viết mã

Bạn không cần phải tự xây dựng tích hợp này.

Tài liệu tham khảo đầy đủ về giao thức được công khai và có thể đọc được bằng máy, cùng với bốn bản triển khai tham chiếu hoàn chỉnh nằm ngay bên cạnh. Hãy đưa bộ tài liệu đó cho bất kỳ trợ lý lập trình AI nào và mô tả điều bạn muốn bằng ngôn ngữ đơn giản: theo dõi funding rate trên ba cặp, và khi cả ba đều chuyển sang âm, đóng tất cả vị thế long của tôi. Bạn sẽ nhận lại một script hoạt động, trỏ đến môi trường demo, cho phép bạn chạy thử và điều chỉnh trước khi nó tác động đến số dư thực tế.

Thời gian trung bình 13 phút này được duy trì vì các phần phức tạp đã có sẵn bằng bốn ngôn ngữ, bao gồm ký số Ed25519, chuỗi yêu cầu chuẩn hóa và logic kết nối lại, nên bạn chỉ cần viết quy tắc giao dịch mà không phải làm gì thêm.

Thị trường liên tục mở rộng với tốc độ nhanh hơn bất kỳ quy trình thủ công nào có thể theo kịp, vì vậy thời gian dành cho các công việc kết nối hệ thống đã trở thành phần tốn kém nhất trong quá trình thiết lập.

Hai kênh, một danh sách chủ đề

Cả hai kênh đều xử lý cùng chủ đề với cùng tham số. REST dành cho một chương trình chỉ hoạt động khi cần, gửi một truy vấn rồi ngừng lại. WebSocket phù hợp với chương trình luôn hoạt động và phản hồi liên tục.

Qua REST, phản hồi của một lệnh xác nhận rằng tác vụ đã được chấp nhận chứ không phải đã hoàn thành. Kết quả thực thi sẽ được gửi qua Đăng ký WebSocket trên orders, positions hoặc balance, hoặc bằng cách truy vấn lại các chủ đề đó. Bộ đếm giới hạn tốc độ được chia sẻ giữa cả hai kênh, vì vậy việc chuyển đổi phương thức truyền tải sẽ không giúp tăng thêm ngân sách.

Những gì bạn sẽ được truy cập

Gọi conf_enums trước. Lệnh này trả về các bảng tham chiếu giúp chuyển tên sàn giao dịch thành các mã số em mà tất cả chủ đề khác đều sử dụng — Binance là 2, Binance demo là 101. Chủ đề manual trả về danh mục trực tiếp của tất cả chủ đề cùng với giới hạn tốc độ hiện tại, để mã của bạn có thể đọc các giới hạn này thay vì phải mã hóa cứng.

Một trường rất đáng sử dụng ngay từ ngày đầu: apiid. Đây là thẻ riêng của bạn trên một Lệnh, tối đa 250 ký tự, và nó sẽ xuất hiện trong mọi báo cáo về Lệnh đó trong tương lai. Hãy đặt tên chiến lược và phiên bản vào trường này. Khi hai chương trình của bạn cùng Giao dịch một cặp, thẻ đó là thứ duy nhất cho bạn biết chương trình nào đã đặt lệnh nào.

API của Bitsgap có an toàn để kết nối không?

Kết nối của Bitsgap với sàn giao dịch của bạn không thay đổi. Đây chỉ là kết nối giao dịch và chưa bao giờ có quyền rút tiền. API tạo ra một kết nối riêng biệt giữa chương trình của bạn và Bitsgap, được ký bằng cặp khóa Ed25519 mà bạn tự tạo và kiểm soát. Ed25519 là một phương thức ký số chứ không phải mật khẩu: bạn giữ phần khóa riêng, Bitsgap chỉ lưu trữ phần khóa công khai, và bí mật này không bao giờ truyền qua mạng. Các yêu cầu không thể bị phát lại, vì mỗi yêu cầu đều có nonce mới và dấu thời gian hết hạn sau mười giây. Khi thu hồi khóa, mọi phiên đang mở sẽ bị ngắt ngay lập tức.

Các giới hạn, tính theo số lượng

Hai yếu tố này ảnh hưởng trực tiếp đến cách bạn xây dựng. Bộ đếm tốc độ được chia sẻ giữa REST và WebSocket theo từng chủ đề, vì vậy một vòng lặp polling sẽ tiêu tốn ngân sách mà một Đăng ký trực tiếp cần. Nếu vượt quá giới hạn tốc độ gửi tin nhắn trên mỗi kết nối, socket sẽ bị đóng thay vì chỉ từ chối tin nhắn, do đó logic kết nối lại cần có cơ chế backoff, khung xác thực mới và thực hiện lại Đăng ký.

Ba yếu tố thường khiến những lần thử đầu tiên thất bại, theo thứ tự sau: đồng hồ không đồng bộ, sử dụng lại nonce, và tuần tự hóa lại nội dung yêu cầu sau khi đã ký. Payload được ký từng byte một, vì vậy chỉ cần thay đổi thứ tự khóa hoặc thêm một khoảng trắng cũng sẽ tạo ra chữ ký khác. Hãy gửi chính xác chuỗi mà bạn đã ký.

Hãy thử nghiệm mà không tốn bất kỳ chi phí nào

Các sàn giao dịch demo hoạt động giống như sàn thật. Lệnh, khớp lệnh, vị thế, số dư — tất cả đều không liên quan đến tiền thật. demo_market_reset sẽ đưa Tài khoản về trạng thái ban đầu, cho phép bạn thử nghiệm một chiến lược đến cùng và khởi động lại chỉ với một lệnh.

API là Free trên mọi gói, bao gồm cả gói Free $0. Không cần thẻ, không nâng cấp, không đồng hồ Dùng thử. Tạo Tài khoản, tạo khóa và bắt đầu ký yêu cầu ngay hôm nay.

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

Bitsgap API là gì? Đây là một API công khai cho phép chương trình của bạn tự động đọc dữ liệu Market và đặt lệnh giao dịch trên bất kỳ sàn nào đã kết nối với Tài khoản Bitsgap của bạn. Các kênh REST và WebSocket sử dụng chung một danh sách chủ đề, được xác thực bằng cặp khóa Ed25519 mà bạn tự tạo và kiểm soát.

API của Bitsgap có miễn phí không? Có. API được bao gồm trong mọi gói, kể cả gói Free, mà không phát sinh thêm chi phí nào.

Tôi có cần biết lập trình không? Bạn chỉ cần biết cách chạy một script. Việc tự viết script phần lớn là tùy chọn: tài liệu tham khảo về giao thức và bốn bản triển khai tham khảo đầy đủ đều được công khai, vì vậy một trợ lý AI lập trình có thể tạo ra một tích hợp hoạt động chỉ từ mô tả ngôn ngữ tự nhiên.

Những ngôn ngữ lập trình nào được hỗ trợ? Bất kỳ ngôn ngữ nào có thể thực hiện yêu cầu HTTPS và tính toán chữ ký Ed25519. Các ví dụ chính thức có thể chạy được cung cấp bằng Go, Rust, Python và TypeScript.

API có thể rút tiền của tôi không? Không. Bitsgap kết nối với sàn giao dịch của bạn bằng khóa chỉ dùng để giao dịch, chưa từng có quyền rút tiền, và API cũng không thay đổi điều đó. Nó chỉ thêm một kênh ký riêng biệt giữa chương trình của bạn và Bitsgap, có thể thu hồi bất cứ lúc nào.

REST hay WebSocket — tôi nên sử dụng cái nào? REST phù hợp cho các truy vấn đơn lẻ và các script chạy theo lịch trình. WebSocket dành cho bất kỳ trường hợp nào cần phản ứng với biến động giá hoặc theo dõi trạng thái lệnh theo thời gian thực.

Tôi có thể thử nghiệm mà không dùng tiền thật không? Có. Các ví dụ chính thức mặc định sử dụng sàn giao dịch demo, và Tài khoản demo có thể được đặt lại về số dư ban đầu bất cứ lúc nào.

Thiết lập mất bao lâu? Thời gian trung vị từ lúc tạo Khóa API đến khi gửi thành công yêu cầu ký đầu tiên là 13 phút, được đo trên các tài khoản Bitsgap đã kết nối Khóa API. [Add measurement window before publish]