Cách kết nối khóa API OKX và khắc phục lỗi 50119

Khóa API OKX của bạn có thể hợp lệ nhưng vẫn trả về “Khóa API không tồn tại.” Nếu khóa EEA được gửi đến API toàn cầu thay vì hạ tầng của OKX Europe, việc tạo lại khóa sẽ không giải quyết được vấn đề. Tôi sẽ chỉ cho bạn cách kết nối khóa API OKX, chọn đúng khu vực tài khoản và chẩn đoán lỗi trước khi thay đổi thông tin xác thực.

Điểm kiểm tra then chốt là sự kết hợp giữa thông tin xác thực và endpoint theo khu vực. Một khóa được sao chép chính xác nhưng gửi đến sai máy chủ khu vực có thể thất bại ngay trước khi các quyền của nó có ý nghĩa.

Khóa API OKX hợp lệ vẫn có thể thất bại tại sai endpoint khu vực

Khi kết nối thất bại, bạn rất dễ chọn cách tạo một khóa khác, dán lại rồi thử cấp thêm quyền. Cách làm đó coi mọi lỗi xác thực đều là vấn đề về thông tin xác thực.

Cấu trúc khu vực của OKX khiến giả định đó không đáng tin cậy.

OKX Europe Limited là một pháp nhân riêng biệt chịu sự quản lý theo MiCA, được cấp phép thông qua MFSA của Malta. Tài khoản EEA nằm trên my.okx.com, và khóa API của các tài khoản này chỉ hợp lệ trên hạ tầng API của OKX Europe.

Gửi một khóa EEA hoàn toàn hợp lệ đến API toàn cầu www.okx.com, và phản hồi có thể là 50119: “Khóa API không tồn tại.” Khóa có tồn tại, nhưng yêu cầu đã đến sai endpoint khu vực.

Tài khoản US có máy chủ khu vực riêng là us.okx.com. Kết nối của các tài khoản này cũng cần hạ tầng khu vực tương ứng.

Tài khoản OKX tại Brazil sử dụng nền tảng toàn cầu và cùng API, vì vậy hãy chọn Global. Sự hiện diện tại một thị trường địa phương không mặc nhiên đồng nghĩa với việc có một khu vực API riêng.

Tôi bắt đầu xử lý sự cố từ đây vì thay đổi cụm mật khẩu hoặc mở rộng quyền không thể khắc phục sự không khớp về khu vực. Yêu cầu phải đến được hạ tầng nhận diện khóa đó.

Cách tạo khóa API OKX với các quyền bạn cần

Một kết nối cần được cấp đủ quyền truy cập để thực hiện nhiệm vụ dự kiến. Cấp thêm quyền chỉ để làm một lỗi biến mất là cách chẩn đoán kém.

Để xem danh mục đầu tư, hãy dùng Read. Chỉ thêm Trade khi bạn định sử dụng bot đặt lệnh.

Không bao giờ bật Withdrawal cho kết nối này.

Thiết lập khóa API OKX từng bước

1. Mở phần quản lý API trong tài khoản OKX của bạn.

Đăng nhập vào tài khoản bạn muốn kết nối rồi đi đến phần quản lý API. Xác định tài khoản đó thuộc Global, EEA hay US trước khi tạo khóa.

1. Tạo khóa API riêng cho kết nối.

Đặt một tên dễ nhận biết để bạn có thể xác định mục đích của khóa khi rà soát quyền truy cập sau này. Khóa riêng cũng giúp bạn dễ thay đổi hoặc thu hồi quyền truy cập của kết nối này một cách độc lập.

1. Đặt cụm mật khẩu API khi tạo khóa.

Đây là cụm mật khẩu bạn chọn cho khóa API. Nó không phải mật khẩu tài khoản OKX, và bạn sẽ cần nó cùng với khóa API và khóa bí mật khi kết nối.

1. Bật Read để xem danh mục đầu tư.

Nếu mục đích của bạn là xem thông tin danh mục đầu tư, hãy bắt đầu với quyền Read. Kết nối chỉ dùng để xem không cần quyền giao dịch.

1. Chỉ thêm Trade cho bot cần đặt lệnh.

Quyền Trade cho phép thực hiện hoạt động giao dịch. Hãy chủ động bật quyền này cho đúng mục đích đó, đừng dùng nó như một phép thử để giải quyết lỗi xác thực.

1. Giữ Withdrawal ở trạng thái tắt.

Xem danh mục đầu tư và để bot đặt lệnh không đòi hỏi quyền rút tiền. Đừng cấp quyền này để hoàn tất thiết lập. Hãy nhớ rằng tắt quyền rút tiền không ngăn được thua lỗ giao dịch: khóa có quyền Trade vẫn có thể đặt những lệnh gây thua lỗ, vì vậy hãy giới hạn số tiền giữ trong tài khoản mà kết nối giao dịch có thể truy cập.

1. Ràng buộc khóa với các địa chỉ IP của kết nối nếu có.

Sử dụng các địa chỉ IP do dịch vụ gửi yêu cầu API chỉ định. Giữ cấu hình đó khớp với kết nối bạn thực sự sử dụng.

1. Lưu trữ khóa API, khóa bí mật và cụm mật khẩu một cách an toàn.

Hãy coi chúng là thông tin xác thực. Khi nhập vào biểu mẫu kết nối, hãy kiểm tra để bảo đảm từng giá trị đều đầy đủ và thuộc cùng một khóa API.

Tạo khóa chỉ là một phần của quá trình thiết lập. Kết nối nhận khóa cũng phải biết cần sử dụng máy chủ khu vực nào.

Vì sao danh sách IP được phép lại quan trọng

Ràng buộc IP giới hạn nơi có thể sử dụng khóa. Nó cũng ảnh hưởng đến vòng đời của khóa: OKX có thể xóa những khóa API không hoạt động và không được ràng buộc IP, vì vậy một khóa bạn đã tạo rồi để đó không dùng có thể không còn tồn tại khi bạn quay lại.

Đừng cho rằng khóa vẫn hoạt động chỉ vì bạn còn lưu thông tin xác thực của nó. Hãy kiểm tra trạng thái trong phần quản lý API của OKX.

Có một vấn đề cấu hình riêng cần chú ý: khóa đang hoạt động có thể từ chối yêu cầu khi IP của bên gửi không nằm trong danh sách được phép. Trường hợp đó tạo ra lỗi cụ thể về IP, và bạn nên kiểm tra phần cài đặt IP thay vì quay lại tạo khóa.

Vì sao OKX báo “Khóa API không tồn tại” khi khóa hợp lệ

Câu thông báo nghe có vẻ dứt khoát. Ý nghĩa chẩn đoán của nó hẹp hơn vẻ bề ngoài.

Với tài khoản EEA, lỗi 50119 có thể có nghĩa là endpoint toàn cầu không nhận diện được một khóa hợp lệ trên hạ tầng của OKX Europe. Nếu hướng dẫn kết nối không bao giờ hỏi tài khoản của bạn thuộc pháp nhân nào, hướng dẫn đó không thể chỉ ra trường hợp này.

Sự phân chia khu vực đã được ghi nhận trong tài liệu, không phải giả thuyết về thông tin xác thực

Phần câu hỏi thường gặp về API OKX EEA ghi rõ bối cảnh khu vực my.okx.com và việc khóa chỉ có hiệu lực trong EEA. Các báo cáo sự cố công khai trong Freqtrade, CCXT và Hummingbot cũng xác nhận hiện tượng người dùng EEA nhận được thông báo “Khóa API không tồn tại” khi phần tích hợp của họ sử dụng máy chủ toàn cầu.

Những báo cáo đó củng cố lý do cần kiểm tra endpoint khu vực. Chúng không chứng minh rằng mọi lần xuất hiện lỗi đều có cùng nguyên nhân.

Kết luận chẩn đoán của tôi rất rõ: xác minh khu vực tài khoản trước khi thay thế một khóa mà OKX vẫn liệt kê là đang hoạt động. Nếu bộ kết nối mặc định rằng mọi tài khoản đều dùng API toàn cầu, việc liên tục tạo khóa mới không thay đổi giả định đó.

Vẫn cần kiểm tra những nguyên nhân khác của lỗi 50119

Không khớp khu vực không phải cách giải thích duy nhất. Lỗi tương tự cũng có thể liên quan đến:

• Khóa giao dịch demo được dùng sai môi trường. Xác nhận thông tin xác thực khớp với môi trường mà kết nối yêu cầu.
• Khóa đã bị tự động xóa. Kiểm tra xem khóa còn tồn tại trong phần quản lý API của OKX hay không.
• Giá trị bị thiếu khi dán. Bảo đảm bạn đã nhập đầy đủ khóa API.
• Khóa thực sự không được nhận diện. Xác nhận thông tin xác thực đến từ đúng tài khoản dự kiến.

Tôi sẽ lần lượt kiểm tra các khả năng này thay vì thay đổi mọi thứ cùng lúc. Nếu bạn đồng thời thay thông tin xác thực, quyền, môi trường và khu vực, một lần thử lại thành công sẽ cho bạn biết rất ít về điều đã sai.

Câu hỏi hữu ích là: Endpoint này có nhận diện khóa đang hoạt động này cho đúng tài khoản và môi trường này không?

Giải mã lỗi OKX trước khi thử lại

Kết nối thất bại là một triệu chứng. Mã lỗi OKX là bằng chứng hữu ích hơn.

Tài liệu mã lỗi API công khai của OKX phân biệt khóa không được nhận diện với cụm mật khẩu sai, chữ ký không hợp lệ và hạn chế IP. Mỗi lỗi chỉ đến một phần khác nhau của kết nối.

Mã lỗi	Ý nghĩa	Cần kiểm tra
50119	Khóa API không tồn tại	Khu vực tài khoản và máy chủ khu vực; môi trường demo so với môi trường dự kiến; khóa có bị xóa hay không; khóa đã dán có đầy đủ hay không
50105	Cụm mật khẩu API sai	Sử dụng cụm mật khẩu đã đặt khi tạo khóa API này, không phải mật khẩu tài khoản
50113	Chữ ký không hợp lệ	Kiểm tra khóa bí mật API và cách phần tích hợp triển khai việc ký yêu cầu
50110	IP gửi yêu cầu không nằm trong danh sách được phép	Kiểm tra xem IP của bên gửi yêu cầu có nằm trong cấu hình IP được phép của khóa hay không

Lỗi 50105: kiểm tra cụm mật khẩu API

Cụm mật khẩu API là một thông tin xác thực riêng. Nhập mật khẩu đăng nhập OKX vào trường đó không đáp ứng được yêu cầu này.

Đồng thời kiểm tra xem cụm mật khẩu có thuộc cùng bộ với khóa API và khóa bí mật hay không. Trộn thông tin xác thực từ những lần tạo khóa khác nhau có thể khiến bạn có các giá trị trông hợp lý khi đứng riêng nhưng lại không thuộc cùng một bộ.

Lỗi 50113: kiểm tra việc ký yêu cầu

Chữ ký không hợp lệ chỉ ra vấn đề ở chữ ký xác thực trên yêu cầu. Hãy kiểm tra khóa bí mật API và, nếu bạn duy trì phần tích hợp, cách triển khai việc ký của nó.

Nếu bạn sử dụng biểu mẫu kết nối, hãy tham khảo bộ phận hỗ trợ hoặc tài liệu kỹ thuật của bộ kết nối để kiểm tra việc ký yêu cầu. Bật Trade hoặc Withdrawal không khắc phục được chữ ký không hợp lệ.

Lỗi 50110: kiểm tra danh sách IP được phép

Lỗi này hướng bạn đến cấu hình IP được phép. Xác minh IP mà dịch vụ gửi yêu cầu sử dụng, rồi so sánh với danh sách được phép của khóa.

Cứ thử lại cùng một yêu cầu một cách mù quáng sẽ không làm sự không khớp biến mất. Hãy sửa cài đặt liên quan trước khi kiểm tra lại.

Cách kết nối OKX với Anny

Biểu mẫu kết nối của tôi có mục chọn Khu vực tài khoản với các tùy chọn Global, EEA và US. Lựa chọn đó bảo đảm khóa được xác minh tại đúng máy chủ khu vực.

Đây là quy trình kết nối:

1. Mở biểu mẫu thêm sàn giao dịch và chọn OKX.

Chuẩn bị sẵn khóa API, khóa bí mật và cụm mật khẩu API.

1. Chọn Khu vực tài khoản của bạn.

Chọn EEA cho tài khoản OKX Europe, US cho tài khoản OKX US hoặc Global cho tài khoản trên nền tảng toàn cầu. Tài khoản tại Brazil chọn Global.

1. Nhập bộ thông tin xác thực tương ứng.

Dán đầy đủ khóa API và khóa bí mật, sau đó nhập cụm mật khẩu bạn đã đặt khi tạo khóa.

1. Xác nhận các quyền phù hợp với mục đích của bạn.

Sử dụng Read để xem danh mục đầu tư. Chỉ thêm Trade cho bot và giữ Withdrawal ở trạng thái tắt.

1. Xác minh kết nối.

Nếu kết nối thất bại, hãy dùng mã lỗi trả về để chọn bước kiểm tra tiếp theo. Với 50119, hãy kiểm tra lại khu vực trước khi tạo khóa khác.

Kết nối OKX với Anny

Chọn khu vực là yêu cầu xác thực, không phải tùy chọn hiển thị. Nó quyết định nơi thông tin xác thực được kiểm tra.

Cách sử dụng tài liệu API OKX khi xử lý sự cố

Nếu bạn kết nối thông qua một biểu mẫu có sẵn, mục chọn khu vực và bảng mã lỗi là những điểm khởi đầu thiết thực. Nếu bạn duy trì một phần tích hợp, hãy đọc hướng dẫn khu vực cùng với tài liệu xác thực.

Các phần liên quan trong tài liệu API OKX trả lời những câu hỏi khác nhau:

• Hướng dẫn API theo khu vực: Hạ tầng nào cần nhận yêu cầu từ tài khoản này?
• Hướng dẫn xác thực: Cần những thông tin xác thực nào, và yêu cầu phải được ký như thế nào?
• Tài liệu mã lỗi: Phần nào trong yêu cầu đã gửi bị từ chối?

Việc ký yêu cầu được triển khai chính xác vẫn có thể gửi yêu cầu đến sai máy chủ khu vực. Máy chủ khu vực chính xác vẫn có thể từ chối một cụm mật khẩu sai.

Tôi giữ các bước kiểm tra đó tách biệt vì chúng dẫn đến những cách sửa khác nhau. Kết nối thành công đòi hỏi endpoint, thông tin xác thực, môi trường, quyền và cấu hình IP phải khớp với nhau.

Câu hỏi thường gặp về kết nối API OKX

Khóa API OKX có hết hạn không?

Đừng cho rằng khóa API sẽ tồn tại vô thời hạn. OKX có thể xóa những khóa không hoạt động và không được ràng buộc IP, vì vậy hãy kiểm tra phần quản lý API nếu thông tin xác thực đã lưu trước đó ngừng hoạt động.

Ràng buộc khóa với các địa chỉ IP được chỉ định cho kết nối nếu có, đồng thời xác minh khóa vẫn hoạt động trước khi xử lý vấn đề về cụm mật khẩu hoặc quyền.

Vì sao khóa API OKX hợp lệ của tôi lại báo không tồn tại?

Một khóa hợp lệ có thể trả về 50119 khi được gửi đến sai endpoint khu vực. Cụ thể, khóa EEA thuộc hạ tầng của OKX Europe; gửi khóa đó đến API toàn cầu www.okx.com có thể tạo ra thông báo “Khóa API không tồn tại.”

Đồng thời kiểm tra khả năng không khớp môi trường demo, khóa bị tự động xóa hoặc giá trị dán chưa đầy đủ.

Bot giao dịch OKX cần những quyền nào?

Sử dụng Read để xem danh mục đầu tư và thêm Trade khi bot cần đặt lệnh. Không bao giờ bật Withdrawal cho kết nối này.

Cấp thêm quyền không giải quyết được sự không khớp về khu vực, cụm mật khẩu sai, chữ ký không hợp lệ hay lỗi danh sách IP được phép.

Cụm mật khẩu API OKX có giống mật khẩu của tôi không?

Không. Cụm mật khẩu API được đặt khi bạn tạo khóa API và tách biệt với mật khẩu tài khoản OKX.

Hãy nhập cụm mật khẩu gắn với chính khóa đó.

Tài khoản OKX tại Brazil nên chọn khu vực nào?

Chọn Global. OKX Brazil hoạt động trên nền tảng toàn cầu và sử dụng cùng API.

Tôi có nên tạo khóa mới mỗi khi kết nối thất bại không?

Không. Trước tiên hãy đọc mã lỗi và kiểm tra cài đặt mà mã đó chỉ ra.

Với 50119, hãy xác nhận máy chủ khu vực, môi trường, trạng thái hoạt động của khóa và tính đầy đủ của giá trị đã dán. Khóa mới sẽ không sửa được một kết nối liên tục gửi khóa đến sai endpoint khu vực.

Hành động hữu ích tiếp theo là chẩn đoán, không phải thêm một lần thử lại y hệt. Bắt đầu từ khu vực, đọc mã lỗi và thay đổi cài đặt mà bằng chứng chỉ ra.

Bài viết này nhằm mục đích giáo dục và không phải lời khuyên tài chính. Hiệu suất trong quá khứ ≠ kết quả trong tương lai. Anny là một nền tảng phân tích sử dụng AI, không phải đơn vị tư vấn đầu tư đã đăng ký.