Các Thông báo Lỗi Bot & Order Thường gặp (và Ý nghĩa của Chúng)

Khi một bot không thể làm điều gì đó, nó hiển thị cho bạn một thông báo ngắn — nhưng không phải lúc nào cũng rõ ràng bạn cần làm gì với nó. Đây là một bảng tra cứu nhanh: tìm thông báo bạn đã thấy, hiểu ý nghĩa của nó, và biết đó là điều bạn tự sửa hay điều exchange tự khắc phục. Để tìm hiểu sâu, mỗi nhóm liên kết đến hướng dẫn troubleshooting chuyên biệt.

Key Takeaways

Hầu hết các lỗi rơi vào một vài nhóm: số dư/margin, API key, đòn bẩy/chế độ margin, giới hạn order, pair bị delist, đặt exit order, và các trục trặc tạm thời phía exchange.
Nhiều thông báo là từ phía exchange và không phải lỗi của bạn (chế độ chỉ hủy, giới hạn tần suất, timeout) — Freya tự động thử lại những lỗi này.
Những lỗi bạn cần sửa thường là số dư, kích thước order, quyền API, hoặc thiết lập đòn bẩy/margin.
Nếu một thông báo nói “kiểm tra vị thế của bạn thủ công”, vị thế của bạn có thể đang không được bảo vệ — hãy đặt take-profit/stop-loss cho nó trên exchange ngay lập tức.
Lỗi kéo dài hoặc không nhận diện được → liên hệ [email protected] kèm thông tin bot và deal.

Số dư & Margin

Thông báo bạn thấy	Ý nghĩa	Cần làm gì
“Số dư không đủ. Vui lòng kiểm tra tiền trong tài khoản của bạn.”	Không đủ tiền khả dụng trên exchange cho order này.	Nạp thêm tiền trên exchange, hoặc giảm số tiền order của bot.
“Margin không đủ. Giảm kích thước vị thế hoặc thêm margin.”	Futures: không đủ margin cho vị thế ở mức đòn bẩy này.	Thêm margin, giảm kích thước vị thế, hoặc điều chỉnh đòn bẩy.
“Giá trị order quá nhỏ. Vui lòng tăng số tiền bot của bạn.”	Dưới mức order tối thiểu của pair.	Tăng số tiền bot lên trên mức tối thiểu của pair.

➡️ Tìm hiểu sâu: Tại sao Bot của Tôi Tạm dừng hoặc Ngừng? và Bot của Bạn Cần Bao nhiêu Vốn.

API Key & Quyền

Thông báo bạn thấy	Ý nghĩa	Cần làm gì
“Lỗi API key. Vui lòng xác minh API key của bạn hợp lệ và có quyền trading.”	Key không hợp lệ, đã bị thu hồi, hoặc thiếu quyền trading.	Kiểm tra lại hoặc tạo lại key với quyền trading được bật.
“API key bị giới hạn IP. Vui lòng thêm IP server vào whitelist của bạn.”	Danh sách IP cho phép của key không bao gồm IP server của Freya.	Thêm IP hiển thị trên màn hình kết nối vào whitelist của key.

➡️ Tìm hiểu sâu: Không thể Kết nối Exchange? Các Lỗi API Key.

Đòn bẩy & Chế độ Margin (Futures)

Thông báo bạn thấy	Ý nghĩa	Cần làm gì
“Giá trị đòn bẩy không hợp lệ. Vui lòng kiểm tra thiết lập exchange của bạn.”	Đòn bẩy không được chấp nhận cho pair này.	Chọn một mức đòn bẩy nằm trong phạm vi cho phép của pair.
“Giá trị vị thế vượt quá mức tối đa cho phép ở đòn bẩy này. Giảm đòn bẩy hoặc kích thước vị thế.”	Notional quá lớn so với bậc đòn bẩy đã chọn.	Giảm đòn bẩy hoặc kích thước vị thế.
“Chế độ vị thế không khớp. Kiểm tra thiết lập chế độ Hedge/One-Way của bạn.”	Hướng của bot xung đột với chế độ vị thế trên exchange của bạn.	Đồng bộ chế độ Hedge/One-Way của exchange với bot — xem Hedge Mode vs One-Way.
“Chế độ multi-asset xung đột với isolated margin. Chuyển sang cross margin hoặc tắt chế độ multi-asset.”	Margin multi-asset không thể kết hợp với isolated margin.	Chuyển sang cross margin hoặc tắt chế độ multi-asset trên exchange.

➡️ Liên quan: Loại Margin: Cross vs Isolated · Hedge Mode vs One-Way.

Vấn đề về Order

Thông báo bạn thấy	Ý nghĩa	Cần làm gì
“Đã đạt số lượng order đang mở tối đa. Đóng bớt một số order trước.”	Bạn đã chạm giới hạn order đang mở của exchange.	Hủy bớt một số order đang mở, rồi thử lại.
“Giá order lệch quá xa so với giá thị trường. Vui lòng thử lại.”	Một mức giá limit nằm ngoài biên độ cho phép của exchange so với thị trường.	Thử lại; với limit entry, hãy đặt giá gần với thị trường hơn.
“Order reduce-only bị từ chối. Vị thế có thể đã được đóng.”	Một order chỉ-đóng bị từ chối — thường là không còn gì để đóng.	Kiểm tra vị thế trên exchange; nhiều khả năng nó đã được đóng.
“Thị trường đang ở chế độ chỉ hủy. Không thể đặt order mới lúc này.”	Exchange đã đưa thị trường vào chế độ chỉ hủy (bảo trì/thanh toán).	Chờ — nó sẽ hết khi exchange mở lại. Không phải lỗi của bạn.
“Không tìm thấy order trên exchange. Nó có thể đã được khớp hoặc hủy.”	Order được tham chiếu không còn tồn tại nữa.	Thường là vô hại — nó đã khớp hoặc bị hủy. Kiểm tra deal.

➡️ Tìm hiểu sâu (vấn đề đóng deal): Deal của Tôi Không chịu Đóng.

Trading Pair (Delist)

Thông báo bạn thấy	Ý nghĩa	Cần làm gì
“Không tìm thấy trading pair. Nó có thể đã bị delist khỏi exchange.”	Pair đã bị gỡ hoặc đổi tên trên exchange.	Chuyển bot sang một pair đang hoạt động, đang được niêm yết.
“Không tìm thấy trading pair trên exchange. Nó có thể đã bị delist.”	Exchange báo rằng công cụ này không tồn tại.	Chọn một pair hiện đang được niêm yết.

Đây là các thay đổi phía exchange, không phải lỗi của bạn — nếu một exchange delist một coin, không bot nào có thể tiếp tục trade nó.

Đặt Exit Order (“Kiểm tra Vị thế của Bạn Thủ công”)

Thông báo bạn thấy	Ý nghĩa	Cần làm gì
“Đặt order take profit/stop loss thất bại. Vui lòng kiểm tra vị thế của bạn thủ công.”	Entry của bạn đã khớp nhưng bảo vệ exit không thể đặt được — vị thế của bạn có thể đang không được bảo vệ.	Tự đặt take-profit/stop-loss trên exchange ngay bây giờ, rồi kiểm tra bot.
“Cập nhật TP/SL thất bại sau khi khớp DCA. Vui lòng kiểm tra vị thế của bạn thủ công.”	Sau khi một safety order khớp, exit không thể được cập nhật theo giá trung bình mới.	Xác minh các mức exit của bạn đã phản ánh giá entry trung bình mới.
“Exit order (TP/SL) của bạn đã bị hủy bên ngoài Freya Finance. Vị thế của bạn không còn được bảo vệ.”	Một exit order đã bị hủy trên exchange, bên ngoài Freya.	Bảo vệ lại vị thế (đặt TP/SL) hoặc đóng nó.

Những lỗi này cần bạn chú ý

Bất kỳ thông báo “kiểm tra vị thế của bạn thủ công” nào đều nghĩa là một vị thế có thể đang chạy mà không có bảo vệ exit. Hãy mở exchange của bạn, xác nhận vị thế, và tự đặt stop-loss / take-profit cho nó cho đến khi bot có thể tiếp quản trở lại.

Trục trặc Tạm thời (Freya Tự Thử lại)

Thông báo bạn thấy	Ý nghĩa	Cần làm gì
“Đã đạt giới hạn tần suất của exchange. Sẽ tự động thử lại.”	Quá nhiều request; bị điều tiết trong chốc lát.	Không cần làm gì — Freya tự thử lại.
“Kết nối exchange đã hết thời gian. Vui lòng thử lại.”	Một request không hoàn thành kịp thời gian.	Chờ một lát; thường thì nó sẽ tự hết.
“Lỗi kết nối mạng. Vui lòng thử lại.”	Một lỗi ở cấp độ mạng khi kết nối tới exchange.	Thử lại sau ít phút.
“Lỗi đồng bộ thời gian server. Lỗi này thường tự khắc phục.”	Đồng hồ/timestamp bị lệch so với exchange.	Thường tự khắc phục; không cần hành động.
“Server exchange đang bận. Vui lòng thử lại sau giây lát.”	Exchange trả về phản hồi bận/không khả dụng.	Chờ và thử lại. Không phải lỗi của bạn.

Vẫn Chưa Giải quyết được?

Nếu bạn thấy “Đã xảy ra lỗi exchange không mong đợi. Vui lòng kiểm tra vị thế của bạn thủ công.” hoặc “Lỗi hệ thống nội bộ. Vui lòng thử lại hoặc liên hệ hỗ trợ.” — hãy xác minh vị thế của bạn trên exchange, và nếu vẫn tiếp diễn, liên hệ [email protected] kèm thông tin bot và deal. Riêng về thanh lý, hãy xem Hiểu về Thanh lý.

Các Câu hỏi Thường gặp

Bot của tôi báo lỗi — có phải lỗi của nền tảng không?

Còn tùy vào thông báo. Lỗi số dư, kích thước order, API key, và đòn bẩy/margin thường là các thiết lập bạn tự sửa. Chế độ chỉ hủy, giới hạn tần suất, timeout, pair bị delist, và “server bận” là từ phía exchange và không phải lỗi của bạn — Freya tự động thử lại những lỗi tạm thời.

“Vui lòng kiểm tra vị thế của bạn thủ công” nghĩa là gì?

Nó nghĩa là entry của bạn đã khớp nhưng Freya không thể đặt hoặc cập nhật bảo vệ exit, nên vị thế có thể đang chạy mà không có stop-loss hoặc take-profit. Hãy mở exchange của bạn, xác nhận vị thế, và tự đặt các mức exit của nó ngay lập tức — rồi kiểm tra bot.