Cara menghubungkan kunci API OKX dan mengatasi error 50119

Kunci API OKX Anda bisa valid tetapi tetap menampilkan “Kunci API tidak ada.” Jika kunci EEA mengarah ke API global alih-alih infrastruktur OKX Europe, membuat ulang kunci tidak akan menyelesaikan masalah. Saya akan menunjukkan cara menghubungkan kunci API OKX, memilih wilayah akun yang tepat, dan mendiagnosis error sebelum mengubah kredensial.

Pemeriksaan terpenting adalah kesesuaian kredensial dan endpoint regional. Kunci yang disalin dengan benar tetapi dikirim ke host regional yang salah bisa gagal sebelum izinnya menjadi faktor yang relevan.

Kunci API OKX yang valid bisa gagal di endpoint regional yang salah

Saat koneksi gagal, Anda mungkin tergoda untuk membuat kunci baru, menempelkannya lagi, lalu mencoba menambahkan izin. Pendekatan itu menganggap setiap kegagalan autentikasi sebagai masalah kredensial.

Struktur regional OKX membuat asumsi tersebut tidak bisa diandalkan.

OKX Europe Limited adalah entitas terpisah yang diatur oleh MiCA dan memperoleh lisensi melalui MFSA Malta. Akun EEA berada di my.okx.com, dan kunci API-nya hanya valid pada infrastruktur API OKX Europe.

Kirim kunci EEA yang sepenuhnya valid ke API global www.okx.com, dan responsnya bisa berupa 50119: “Kunci API tidak ada.” Kunci itu ada, tetapi permintaannya telah mencapai endpoint regional yang salah.

Akun US memiliki host regional sendiri, yaitu us.okx.com. Koneksinya juga memerlukan infrastruktur regional yang sesuai.

Akun OKX Brasil menggunakan platform global dan API yang sama, jadi pilih Global. Kehadiran di pasar lokal tidak otomatis berarti ada wilayah API terpisah.

Saya memulai pemecahan masalah dari sini karena mengganti frasa sandi atau memperluas izin tidak dapat memperbaiki ketidakcocokan wilayah. Permintaan harus mencapai infrastruktur yang mengenali kunci tersebut.

Cara membuat kunci API OKX dengan izin yang Anda perlukan

Sebuah koneksi perlu mendapat akses yang cukup untuk menjalankan tugas yang dimaksud. Memberikan izin tambahan agar error menghilang adalah metode diagnosis yang buruk.

Untuk melihat portofolio, gunakan Read. Tambahkan Trade hanya jika Anda berniat menggunakan bot yang memasang order.

Jangan pernah mengaktifkan Withdrawal untuk koneksi ini.

Langkah-langkah menyiapkan kunci API OKX

1. Buka pengelolaan API di akun OKX Anda.

Masuk ke akun yang ingin Anda hubungkan, lalu buka bagian pengelolaan API. Pastikan apakah akun tersebut termasuk Global, EEA, atau US sebelum membuat kunci.

1. Buat kunci API khusus untuk koneksi tersebut.

Beri nama yang mudah dikenali agar Anda dapat mengidentifikasi tujuannya saat meninjau akses nanti. Kunci khusus juga memudahkan Anda mengubah atau mencabut akses koneksi ini secara terpisah.

1. Tetapkan frasa sandi API saat membuat kunci.

Ini adalah frasa sandi yang Anda pilih untuk kunci API tersebut. Frasa sandi ini bukan kata sandi akun OKX Anda, dan Anda akan membutuhkannya bersama kunci API dan secret saat menghubungkan akun.

1. Aktifkan Read untuk melihat portofolio.

Jika tujuan Anda adalah melihat informasi portofolio, mulailah dengan akses Read. Koneksi yang hanya digunakan untuk melihat informasi tidak memerlukan izin trading.

1. Tambahkan Trade hanya untuk bot yang perlu memasang order.

Izin Trade memberikan kewenangan untuk melakukan aktivitas trading. Aktifkan dengan sengaja untuk tujuan tersebut, bukan sebagai percobaan untuk mengatasi error autentikasi.

1. Biarkan Withdrawal nonaktif.

Melihat portofolio dan memasang order melalui bot tidak memerlukan izin penarikan. Jangan memberikan izin tersebut untuk menyelesaikan pengaturan ini. Ingat bahwa menonaktifkan penarikan tidak mencegah kerugian trading: kunci dengan izin Trade tetap dapat memasang order yang merugi, jadi batasi dana yang disimpan dalam akun yang dapat diakses oleh koneksi trading.

1. Ikat kunci ke alamat IP koneksi jika tersedia.

Gunakan alamat IP yang ditentukan oleh layanan yang mengirimkan permintaan API. Pastikan konfigurasi tersebut sesuai dengan koneksi yang benar-benar Anda gunakan.

1. Simpan kunci API, secret, dan frasa sandi dengan aman.

Perlakukan semuanya sebagai kredensial. Saat memasukkannya ke formulir koneksi, periksa bahwa setiap nilai lengkap dan berasal dari kunci API yang sama.

Membuat kunci hanyalah sebagian dari proses pengaturan. Koneksi yang menerima kredensial juga harus mengetahui host regional mana yang perlu digunakan.

Mengapa daftar IP yang diizinkan itu penting

Pengikatan IP membatasi dari mana sebuah kunci dapat digunakan. Ini juga berpengaruh pada siklus hidup kunci: OKX dapat menghapus kunci API tidak aktif yang tidak memiliki pengikatan IP, sehingga kunci yang Anda buat lalu dibiarkan tidak terpakai mungkin sudah tidak ada saat Anda kembali menggunakannya.

Jangan menganggap kunci tetap aktif hanya karena Anda masih menyimpan kredensialnya. Periksa statusnya di pengelolaan API OKX.

Ada masalah konfigurasi lain yang perlu diperhatikan: kunci aktif dapat menolak permintaan jika IP pengirim tidak ada dalam daftar IP yang diizinkan. Kondisi ini menghasilkan error khusus IP, yang seharusnya mengarahkan Anda ke pengaturan IP, bukan kembali membuat kunci.

Mengapa OKX menyatakan “Kunci API tidak ada” padahal kuncinya valid

Kalimat itu terdengar mutlak. Maknanya dalam diagnosis lebih terbatas daripada yang terlihat.

Untuk akun EEA, error 50119 dapat berarti endpoint global tidak mengenali kunci yang valid pada infrastruktur OKX Europe. Jika panduan koneksi tidak pernah menanyakan entitas tempat akun Anda terdaftar, panduan tersebut tidak dapat mengungkap kasus ini.

Pembagian regional ini terdokumentasi, bukan teori tentang kredensial

FAQ API OKX EEA mendokumentasikan konteks regional my.okx.com dan validitas kunci yang khusus untuk EEA. Laporan masalah publik di Freqtrade, CCXT, dan Hummingbot juga menguatkan pola pengguna EEA yang menerima pesan “Kunci API tidak ada” ketika integrasinya menggunakan host global.

Laporan tersebut mendukung perlunya memeriksa endpoint regional. Laporan itu tidak membuktikan bahwa setiap kejadian memiliki penyebab yang sama.

Kesimpulan diagnosis saya sederhana: verifikasi wilayah akun sebelum mengganti kunci yang masih tercatat aktif di OKX. Jika konektor menganggap setiap akun menggunakan API global, membuat kunci berulang kali tidak mengubah asumsi tersebut.

Penyebab lain error 50119 tetap perlu diperiksa

Ketidakcocokan wilayah bukan satu-satunya penjelasan. Error yang sama juga bisa berkaitan dengan:

• Kunci demo trading yang digunakan di lingkungan yang salah. Pastikan kredensial sesuai dengan lingkungan yang diharapkan oleh koneksi.
• Kunci yang dihapus secara otomatis. Periksa apakah kunci tersebut masih ada di pengelolaan API OKX.
• Hasil tempelan yang terpotong. Pastikan kunci API dimasukkan secara lengkap.
• Kunci yang memang tidak dikenal. Pastikan kredensial berasal dari akun yang dimaksud.

Saya akan memeriksa kemungkinan ini secara berurutan, alih-alih mengubah semuanya sekaligus. Jika Anda mengganti kredensial, izin, lingkungan, dan wilayah secara bersamaan, keberhasilan percobaan berikutnya hanya memberi sedikit petunjuk tentang apa yang sebelumnya salah.

Pertanyaan yang berguna adalah: Apakah endpoint ini mengenali kunci aktif ini untuk akun dan lingkungan ini?

Pahami kode error OKX sebelum mencoba lagi

Koneksi yang gagal adalah gejala. Kode error OKX adalah bukti yang lebih berguna.

Referensi publik kode error API OKX membedakan kunci yang tidak dikenal dari frasa sandi yang salah, tanda tangan yang tidak valid, dan pembatasan IP. Masing-masing mengarah ke bagian koneksi yang berbeda.

Kode error	Arti	Yang perlu diperiksa
50119	Kunci API tidak ada	Wilayah akun dan host regional; lingkungan demo dibandingkan dengan lingkungan yang dimaksud; apakah kunci telah dihapus; apakah kunci yang ditempel lengkap
50105	Frasa sandi API salah	Gunakan frasa sandi yang ditetapkan saat kunci API ini dibuat, bukan kata sandi akun
50113	Tanda tangan tidak valid	Periksa secret API dan implementasi penandatanganan permintaan pada integrasi
50110	IP permintaan tidak ada dalam daftar yang diizinkan	Periksa apakah IP pengirim permintaan tercantum dalam konfigurasi IP yang diizinkan untuk kunci tersebut

Error 50105: periksa frasa sandi API

Frasa sandi API adalah kredensial tersendiri. Memasukkan kata sandi login OKX Anda ke kolom tersebut tidak memenuhi persyaratannya.

Periksa juga bahwa frasa sandi berasal dari kunci yang sama dengan kunci API dan secret. Mencampur kredensial dari beberapa percobaan pembuatan kunci bisa menghasilkan nilai yang masing-masing terlihat masuk akal, tetapi tidak cocok satu sama lain.

Error 50113: selidiki penandatanganan permintaan

Tanda tangan yang tidak valid mengarah pada tanda tangan autentikasi dalam permintaan. Periksa secret API dan, jika Anda mengelola integrasinya, implementasi penandatanganannya.

Jika Anda menggunakan formulir koneksi, hubungi dukungan konektor atau baca dokumentasi teknisnya untuk menyelidiki penandatanganan permintaan. Mengaktifkan Trade atau Withdrawal bukan solusi untuk tanda tangan yang tidak valid.

Error 50110: periksa daftar IP yang diizinkan

Error ini mengarahkan Anda ke konfigurasi IP yang diizinkan. Verifikasi IP yang digunakan oleh layanan pengirim permintaan, lalu bandingkan dengan daftar IP yang diizinkan untuk kunci tersebut.

Mengulangi permintaan yang sama tanpa pemeriksaan membiarkan ketidakcocokan tetap ada. Perbaiki pengaturan yang relevan sebelum menguji kembali.

Cara menghubungkan OKX ke Anny

Formulir koneksi saya menyertakan pilihan Account region dengan opsi Global, EEA, dan US. Pilihan tersebut memastikan kunci diverifikasi melalui host regional yang tepat.

Berikut proses menghubungkannya:

1. Buka formulir penambahan exchange dan pilih OKX.

Siapkan kunci API, secret, dan frasa sandi API Anda.

1. Pilih Account region Anda.

Pilih EEA untuk akun OKX Europe, US untuk akun OKX US, atau Global untuk akun pada platform global. Akun Brasil memilih Global.

1. Masukkan kredensial yang sesuai.

Tempel kunci API dan secret secara lengkap, lalu masukkan frasa sandi yang Anda tetapkan saat membuat kunci.

1. Pastikan izin sesuai dengan tujuan Anda.

Gunakan Read untuk melihat portofolio. Tambahkan Trade hanya untuk bot, dan biarkan Withdrawal nonaktif.

1. Verifikasi koneksi.

Jika gagal, gunakan kode error yang diterima untuk menentukan pemeriksaan berikutnya. Untuk 50119, periksa kembali wilayah sebelum membuat kunci baru.

Hubungkan OKX ke Anny

Memilih wilayah adalah persyaratan autentikasi, bukan preferensi tampilan. Pilihan itu menentukan tempat kredensial diperiksa.

Cara menggunakan dokumentasi API OKX saat memecahkan masalah

Jika Anda menghubungkan akun melalui formulir yang sudah tersedia, pilihan wilayah dan tabel error adalah titik awal yang praktis. Jika Anda mengelola integrasi, baca panduan regional bersama dokumentasi autentikasi.

Bagian-bagian yang relevan dalam dokumentasi API OKX menjawab pertanyaan yang berbeda:

• Panduan API regional: Infrastruktur mana yang harus menerima permintaan akun ini?
• Panduan autentikasi: Kredensial apa yang diperlukan, dan bagaimana permintaan harus ditandatangani?
• Referensi kode error: Bagian mana dari permintaan yang dikirim ditolak?

Implementasi penandatanganan yang benar tetap dapat mengirim permintaan ke host regional yang salah. Host regional yang benar tetap dapat menolak frasa sandi yang keliru.

Saya memisahkan pemeriksaan tersebut karena masing-masing mengarah ke perbaikan yang berbeda. Koneksi yang berhasil memerlukan kesesuaian endpoint, kredensial, lingkungan, izin, dan konfigurasi IP.

Pertanyaan umum tentang koneksi API OKX

Apakah kunci API OKX bisa kedaluwarsa?

Jangan menganggap kunci API tetap tersedia selamanya. OKX dapat menghapus kunci tidak aktif yang tidak memiliki pengikatan IP, jadi periksa pengelolaan API jika kredensial yang sebelumnya disimpan berhenti berfungsi.

Ikat kunci ke alamat IP yang ditentukan untuk koneksi jika tersedia, dan pastikan kunci masih aktif sebelum memeriksa masalah frasa sandi atau izinnya.

Mengapa kunci API OKX saya yang valid dinyatakan tidak ada?

Kunci yang valid dapat menghasilkan 50119 ketika dikirim ke endpoint regional yang salah. Secara khusus, kunci EEA harus digunakan pada infrastruktur OKX Europe; mengirimkannya ke API global www.okx.com dapat menghasilkan pesan “Kunci API tidak ada.”

Periksa juga ketidakcocokan lingkungan demo, kunci yang dihapus secara otomatis, atau hasil tempelan yang tidak lengkap.

Izin apa yang dibutuhkan bot trading OKX?

Gunakan Read untuk melihat portofolio dan tambahkan Trade jika bot perlu memasang order. Jangan pernah mengaktifkan Withdrawal untuk koneksi ini.

Izin tambahan tidak menyelesaikan ketidakcocokan wilayah, frasa sandi yang salah, tanda tangan yang tidak valid, atau error daftar IP yang diizinkan.

Apakah frasa sandi API OKX sama dengan kata sandi saya?

Tidak. Frasa sandi API ditetapkan saat Anda membuat kunci API dan terpisah dari kata sandi akun OKX Anda.

Masukkan frasa sandi yang terkait dengan kunci tersebut.

Wilayah mana yang harus dipilih oleh akun OKX Brasil?

Pilih Global. OKX Brazil beroperasi pada platform global dan menggunakan API yang sama.

Haruskah saya membuat kunci baru setiap kali koneksi gagal?

Tidak. Baca kode error terlebih dahulu dan periksa pengaturan yang ditunjukkannya.

Untuk 50119, pastikan host regional, lingkungan, status aktif kunci, dan kelengkapan nilai yang ditempel sudah benar. Kunci baru tidak akan memperbaiki koneksi yang terus mengirimkannya ke endpoint regional yang salah.

Tindakan berikutnya yang berguna adalah diagnosis, bukan percobaan ulang yang sama persis. Mulailah dari wilayah, baca kodenya, lalu ubah pengaturan yang ditunjukkan oleh bukti.

Artikel ini bersifat edukatif dan bukan nasihat keuangan. Kinerja masa lalu ≠ hasil di masa depan. Anny adalah platform analitik berbasis AI, bukan penasihat investasi terdaftar.