FAQs

chevron-rightBackpack hỗ trợ những API nào?hashtag

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ế)

chevron-rightAPI có thể dùng để giao dịch hợp đồng tương lai không?hashtag

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

chevron-rightTôi có thể rút tài sản bằng API không?hashtag

Để 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=truearrow-up-right

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

chevron-rightGiới hạn tốc độ API là gì? Chúng khác nhau theo server hay theo subaccount?hashtag

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.

chevron-rightCác lỗi phổ biến khi đặt lệnh là gì?hashtag

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.

chevron-rightTôi có thể tìm SDK ở đâu?hashtag

SDK chính thức hiện chỉ có bằng Rust: https://github.com/backpack-exchange/bpx-api-clientarrow-up-right 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-clientsarrow-up-right

chevron-rightLà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?hashtag

Sử dụng WebSocket streams để cập nhật thị trường trực tiếp:

Book Tickerarrow-up-right (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.

Deptharrow-up-right (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/Streamsarrow-up-right

chevron-rightLàm thế nào để cải thiện độ ổn định của trading bot?hashtag

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