1. Đăng nhập vào tài khoản cá nhân Gate của bạn và nhấp vào "Ảnh đại diện" - "Quản lý API" ở góc trên bên phải.
2. Nhấp vào "Tạo khóa API" trên trang hiển thị.
3. Tạo API Key
Tạo khóa APIv2:
① Quyền IP: Bạn có thể chọn liên kết hoặc không liên kết IP. Lưu ý: Nếu không liên kết IP, API Key sẽ được sử dụng từ bất kỳ địa chỉ nào và có hiệu lực trong 90 ngày.
② Loại API Key: Chọn khóa API v2. Mỗi người dùng chỉ có thể tạo 1 bộ, bộ mới sẽ ghi đè bộ cũ. Sau đó bạn có thể chọn: "Đọc và ghi" hoặc "Chỉ đọc".
③ Xác nhận thông tin và nhấp vào "Gửi" để hoàn tất.
Lưu ý: Sau khi tạo khóa API mới, khóa API cũ sẽ ngay lập tức mất hiệu lực.
API key có thể được dùng để truy vấn thông tin tài khoản, giao dịch hoặc rút tiền. Vui lòng bảo quản kỹ và không chia sẻ với người khác!
Tạo khóa APIv4:
① Ghi chú khóa API: Giúp bạn ghi nhớ và xác định rõ ràng từng key.
② Quyền IP: Tùy chọn liên kết IP như trên.
③ Loại khóa API: Chọn API v4.
④ Loại tài khoản: Chọn tài khoản Thường / Ký quỹ / Testnet.
⑤ Quyền: Chọn “Đọc và ghi” hoặc “Chỉ đọc”. Lưu ý: Không được để trống cặp giao dịch.
⑥ Xác nhận thông tin và nhấn “Gửi” để hoàn tất.
4. Sau khi nhấn "Gửi", hệ thống sẽ hiển thị nhắc nhở rủi ro. Vui lòng đọc kỹ cảnh báo và chọn "Tôi chấp nhận" hoặc "Hủy" để tiếp tục.
Nhập mật khẩu quỹ, chọn phương thức xác thực 2FA và nhấp "Xác nhận" để hoàn tất.
5. Sau khi tạo khóa API, bạn có thể xem, chỉnh sửa hoặc xóa khóa.
6. Chú ý:
① Khóa APIv2/4 có quyền nạp và rút tiền. Khi dùng API để rút, bạn phải dùng địa chỉ đã từng rút thủ công và thời gian kể từ lần rút thủ công gần nhất phải trên 24 giờ.
② Sự khác biệt giữa APIv2 và APIv4:
• Khóa APIv2 và APIv4 là độc lập với nhau.
• APIv2 chỉ hỗ trợ giao dịch giao ngay, còn APIv4 hỗ trợ đầy đủ: giao ngay, ký quỹ và hợp đồng.
• APIv2 được tạo trong mục "Khóa APIv2", còn APIv4 được tạo tại "Trung tâm cá nhân" - "Tài khoản phụ và API" - "Khóa APIv4".
Hãy chọn loại API phù hợp với nhu cầu sử dụng của bạn. Tham khảo bài viết này để cập nhật thông tin mới nhất.
Nếu tài liệu không giải đáp được vấn đề của bạn, vui lòng gửi yêu cầu hỗ trợ. Khi gửi, vui lòng cung cấp:
UID của bạn, URL của yêu cầu ban đầu, thông số và mô tả chi tiết yêu cầu, loại API dùng cho giao dịch nào (giao ngay/ký quỹ, testnet/mainnet), ngôn ngữ lập trình (nên đính kèm đoạn mã gửi yêu cầu), có dùng SDK không (nếu có, vui lòng nêu rõ cách dùng hoặc để lại comment trên GitHub).
7. Tài liệu API có thể được truy cập qua mục "Dịch vụ" - "Trung tâm nhà phát triển (API)" ở cuối trang.
8. Quy tắc giới hạn tần suất
| Markets | Endpoints | Limits | Based On | Include |
|---|---|---|---|---|
| All public endpoints | Public endpoints | 200r/10s per endpoint | IP | Orderbook, Candlestick, Ticker, etc. |
| Wallet | Private endpoints | Withdrawal(POST /withdrawals) : 1r/3s UID transfer(POST /withdrawals/push) 1r/10s Transfer between trading accounts (POST /wallet/transfers) 80r/10s Transfer between main and sub accounts (POST /wallet/sub_account_transfers) 80r/10s Transfer from a sub-account to another sub-account (POST /wallet/sub_account_to_sub_account) 80r/10s Retrieve user's total balances (GET /wallet/total_balance) 80r/10s Retrieve sub account balances (GET /wallet/sub_account_balances) 80r/10s Query sub accounts' margin balances (GET /wallet/sub_account_margin_balances) 80r/10s Query sub accounts' futures account balances (GET /wallet/sub_account_futures_balances) 80r/10s Query subaccount's cross_margin account info(GET /wallet/sub_account_cross_margin_balances) 80r/10s The Others: 200r/10s per endpoint |
UID | Withdrawal. Query personal account balance. Query subaccount balance. |
| Spot | Private endpoints | The rate limit for batch/single order placement and amend an order are total of 10r/s (UID+Market) The rate limit for batch/single order cancellation is total of 200r/s The Others: 200r/10s per endpoint |
UID | Spot order placement and cancellation. Trade history and fee rates. |
| Perpetual Futures | Private endpoints | The rate limit for batch/single order placement and amend an order are total of 100r/s The maximum rate limit for the order cancellation (bulk/single) is 200r/s The Others: 200r/10s per endpoint |
UID | Futures order placement and cancellation Trade history and fee rates |
| Delivery | Private endpoints | The maximum rate limit for the order placement (bulk/single) is 500r/10s The maximum rate limit for the order cancellation (bulk/single) is 500r/10s The Others: 200r/10s per endpoint |
UID | Order placement and cancellation |
| Options | Private endpoints | The maximum rate limit for the order placement (bulk/single) is 200r/s The maximum rate limit for the order cancellation (bulk/single) is 200r/s The Others: 200r/10s per endpoint |
UID | Order placement and cancellation |
| Subaccount | Private endpoints | 80r/10s per endpoint | UID | Create a sub-account. Retrieve the list of sub-accounts. Disable or enable API key for a sub-account. |
| Unified | Private endpoints | Borrow or repay 15/10s | UID | Borrow or repay(POST /unified/loans) |
| Other Private endpoints | Private endpoints | 150r/10s per endpoint | UID | Earning, collateral etc |
Giới hạn được tính riêng cho từng tài khoản phụ hoặc tài khoản chính.
WebSocket:
• Không giới hạn số lượng tin nhắn gửi đến server.
• Số kết nối tối đa mỗi IP: ≤ 300
Lưu ý:
Khi vi phạm giới hạn tần suất nhiều lần:
• Nếu tần suất yêu cầu < burst rate, yêu cầu sẽ bị trì hoãn.
• Nếu tần suất yêu cầu > burst rate, yêu cầu sẽ bị từ chối.
