FAQs
Backpack hỗ trợ những API nào?
Backpack cung cấp hai cách tích hợp, tùy thuộc vào việc bạn cần các thao tác request/response hay dữ liệu streaming theo thời gian thực.
REST API
Sử dụng REST API cho các thao tác theo yêu cầu như lấy dữ liệu thị trường/tài khoản và quản lý lệnh.
Các endpoint phổ biến bao gồm:
GET /markets
GET /balances
POST /orders
DELETE /orders
WebSocket API
Sử dụng WebSocket API cho các luồng thời gian thực có độ trễ thấp.
Các trường hợp sử dụng phổ biến bao gồm:
Đăng ký cập nhật sổ lệnh (order book)
Đăng ký luồng nến (kline)
Đăng ký các sự kiện tài khoản được xác thực (ví dụ: cập nhật lệnh và vị thế)
API có thể dùng để giao dịch hợp đồng tương lai không?
Có. Backpack hỗ trợ cả spot và perpetual futures thông qua cùng một endpoint lệnh và tài khoản. Để giao dịch perp, hãy sử dụng ký hiệu thị trường perp.
Ví dụ: POST /orders - SOL_USDC_PERP
Tôi có thể rút tài sản bằng API không?
Để bật rút tiền, cần có các biện pháp kiểm soát bảo mật nghiêm ngặt (bao gồm xác thực hai yếu tố).
Để cấu hình địa chỉ rút tiền với 2FA bắt buộc, vui lòng sử dụng: https://backpack.exchange/settings/withdrawal-addresses?twoFactorWithdrawalAddress=true
Tham số twoFactorToken (https://docs.backpack.exchange/#tag/Capital/operation/request_withdrawal:~:text=asset%20to%20withdraw.-,twoFactorToken,-string) hiện đang bị vô hiệu hóa
Giới hạn tốc độ API là gì? Chúng khác nhau theo server hay theo subaccount?
Giới hạn tốc độ được áp dụng theo subaccount, không phải theo server. Theo mặc định, mỗi subaccount có thể thực hiện tối đa 2000 request mỗi phút trên các REST endpoint tiêu chuẩn.
Các endpoint dữ liệu thị trường lịch sử bị giới hạn ở mức 30 request mỗi phút mỗi subaccount. ("Endpoint lịch sử" đề cập đến các REST route trả về dữ liệu theo khoảng thời gian như candles/trades.)
Nếu bạn chạm giới hạn, bạn sẽ nhận được phản hồi HTTP 429. Hãy cân nhắc sử dụng WebSocket streams cho dữ liệu thị trường tần suất cao.
Các lỗi phổ biến khi đặt lệnh là gì?
Error Code
Mô tả
Cách xử lý
INVALID_CLIENT_REQUEST'
Invalid signature / Chữ ký không hợp lệ
Xác minh phương thức tạo query string (sorting, instruction, value). Đồng thời kiểm tra các giá trị boolean trong query string phải viết thường. "True" phải là "true".
INVALID_CLIENT_REQUEST'
Request has expired / Yêu cầu đã hết hạn
Thời gian request đến máy chủ sàn vượt quá giá trị X-Window. Hãy thử tăng giá trị window.
INVALID_CLIENT_REQUEST'
Quantity decimal too long / Số thập phân của số lượng quá dài
Điều chỉnh số lượng theo stepSize.
INVALID_CLIENT_REQUEST'
Invalid X-Signature Header / Header X-Signature không hợp lệ
Query string được ký bằng sai keypair. Xác minh rằng bạn đang sử dụng ED25519.
429
Too many requests / Quá nhiều yêu cầu
Giảm tần suất request; cân nhắc sử dụng WebSocket streaming.
Tôi có thể tìm SDK ở đâu?
SDK chính thức hiện chỉ có bằng Rust: https://github.com/backpack-exchange/bpx-api-client Vui lòng tham khảo trang sau để xem các ví dụ do cộng đồng duy trì bằng nhiều ngôn ngữ khác nhau: https://support.backpack.exchange/exchange/api-and-developer-docs/api-clients
Làm thế nào để lấy dữ liệu thị trường theo thời gian thực cho một cặp giao dịch?
Sử dụng WebSocket streams để cập nhật thị trường trực tiếp:
Book Ticker (bookTicker.<symbol>) Giá bid/ask tốt nhất và số lượng theo thời gian thực. Lý tưởng cho hiển thị top-of-book.
Depth (depth.<symbol>) Cập nhật order book theo từng bước. Bắt đầu bằng cách lấy snapshot ban đầu qua REST, sau đó áp dụng các depth delta từ stream. Depth có thể dùng ở chế độ thời gian thực hoặc tổng hợp (ví dụ: 200ms / 600ms / 1000ms) để giảm lưu lượng. Xem danh sách đầy đủ các stream tại đây: https://docs.backpack.exchange/#tag/Streams
Làm thế nào để cải thiện độ ổn định của trading bot?
Các best practice được khuyến nghị:
Ưu tiên WebSocket subscriptions cho cập nhật lệnh/giao dịch thời gian thực thay vì polling REST
Áp dụng retry + exponential backoff cho các request REST và kết nối lại WS
Lưu cache local cho các dữ liệu tham chiếu thường dùng (markets, symbols, filters) và làm mới định kỳ
Theo dõi và cảnh báo các lỗi API quan trọng (lỗi xác thực, request hết hạn, và rate limit 429)
Last updated
