OKX API Pertanyaan yang Sering Diajukan (FAQ)
Apa yang dimaksud dengan Passphrase?
Ini adalah kata sandi yang Anda isi saat mengajukan Kunci API. Anda harus mengingatnya sendiri. Jika Anda lupa, Anda tidak dapat mengambilnya kembali dan harus membuat Kunci API baru.
Bagaimana cara membuat Kunci API?
Di Aplikasi:
1. Masuk ke Akun OKX Anda > Pilih Menu (⋮⋮⋮) > Gulir ke bawah dan pilih Kunci API > Buat Kunci API
2. Isi nama API > Pilih Akun dan Tujuan > Masukkan allowlist alamat IP > Pilih Izin > Masukkan Parafrase
Di Web:
1. Masuk ke Akun OKX Anda > Buka Profil Anda dan pilih API dan koneksi > Buat Kunci API
2. Isi nama Kunci API > Pilih Akun dan Digunakan untuk
3. Masukkan allowlist alamat IP > Pilih Izin > Masukkan Paraphrase
Catatan:
Alamat IP membantu mengamankan Kunci API Anda. Anda dapat menghubungkan hingga 20 alamat per kunci, pisahkan dengan koma atau spasi.
Anda harus melihat info API dan mengakses antarmukanya. Harap jaga kata sandi Anda dengan aman. Anda dapat membuat API baru jika kehilangan kata sandi, karena kami tidak dapat memulihkan API.
Bagaimana cara mengelola atau mengedit Kunci API?
Untuk mengelola atau mengedit Kunci API Anda di OKX:
Masuk ke Akun OKX Anda dan buka Profil > API.
Anda akan melihat daftar API key yang sudah ada. Klik pada yang ingin Anda kelola.
Dari sini Anda dapat:
Lihat nama Kunci API, izin, dan daftar putih IP yang terhubung.
Edit nama kunci, izin (Baca, Trading, Tarik), atau alamat IP yang terikat.
Hapus kunci jika sudah tidak diperlukan.
Catatan: Anda tidak dapat melihat Passphrase setelah pembuatan awal. Jika hilang, Anda harus menghapus kunci yang ada dan membuat yang baru. Selalu simpan kredensial Anda dengan aman.
Bagaimana cara membedakan antara spot atau trading margin jika saya trading menggunakan API?
Cara membedakan spot dan trading margin melalui API dapat bervariasi tergantung pada jenis dan pengaturan akun Anda. Kami menyarankan untuk merujuk ke dokumentasi API OKX untuk parameter yang paling akurat dan terbaru yang berlaku untuk pengaturan akun Anda.
Jika Anda memerlukan penjelasan lebih lanjut, silakan hubungi Asisten OKX untuk panduan yang dipersonalisasi.
Bagaimana cara membuat kunci API demo disk?
Untuk trading di demo disk API, Anda perlu membuat Kunci API di demo disk. Ikuti langkah-langkah berikut:
Masuk ke Akun OKX Anda > Trading > Simulasi Trading > Pusat Pribadi > Buat Kunci API Akun Simulasi > Mulai Simulasi Trading
Apakah Kunci API akan kedaluwarsa?
API key yang tidak terikat pada IP dan memiliki izin transaksi atau penarikan akan dihapus secara otomatis setelah 14 hari tidak aktif. API key tidak akan dianggap tidak aktif jika digunakan untuk memanggil antarmuka pribadi atau terkait akun yang memerlukan Verifikasi Identitas, seperti melihat Saldo Akun, data tagihan, atau melakukan Order.
Hanya kunci API read-only yang terikat pada IP atau izin tertentu yang tidak akan kedaluwarsa.
Apa itu izin Loan, Earn, dan Transfer?
Transfer: Mengizinkan kunci untuk melakukan transfer dana antar Akun Anda. Tersedia untuk semua Akun.
Loan: Memungkinkan kunci untuk Pinjam, lunasi, dan mengelola Loan. Hanya terlihat jika Akun Anda memiliki kelayakan fitur yang diperlukan.
Dapatkan: Mengizinkan kunci untuk berlangganan dan mencairkan produk Dapatkan. Hanya terlihat jika akun Anda memiliki kelayakan fitur yang diperlukan.
Jika API Key Anda sebelumnya memiliki izin Trading yang diaktifkan, ketiga izin tersebut akan otomatis diaktifkan setelah pembaruan ini. Tidak diperlukan pengaturan manual.
Apakah Order dapat ditempatkan dalam satuan Mata Uang saat melakukan Order melalui antarmuka?
Tidak; untuk order kontrak, antarmuka secara default menggunakan order dalam jumlah kontrak. Jika Anda perlu menghitung konversi antara jumlah kontrak dan koin, Anda dapat merujuk ke antarmuka konversi jumlah kontrak ke koin di sini.
Bagaimana cara mendapatkan tingkat fluktuasi antarmuka?
Antarmuka tidak dapat langsung memperoleh kenaikan atau penurunan harga, tetapi dapat dihitung melalui rumus perhitungan.
Nilai naik turun harga transaksi terbaru dibandingkan dengan harga pembukaan K-line 24 jam lalu/100% dari harga pembukaan K-line 24 jam lalu.
Data rumus di atas dapat diperoleh melalui antarmuka market di sini.
Apa penyebab munculnya pesan kesalahan "51000 Parameter posSide error" saat melakukan Order?
Anda perlu memeriksa mode akun terlebih dahulu; mode membeli dan menjual/mode membuka dan menutup, yang dapat dilihat di sini untuk mendapatkan posMode.
Catatan:
Dalam kasus membuka dan menutup posisi serta memasang order menggunakan kontrak, parameter posSide diperlukan, dan diisi dengan Long atau Short.
Jika dalam mode beli dan jual, atau transaksi mata uang kripto atau leverage dilakukan di bawah mode pembukaan dan penutupan, posSide hanya mendukung net atau tanpa transmisi.
Antarmuka mana yang dapat digunakan untuk memperoleh nilai nominal kontrak dan kuantitas order minimum?
Anda dapat menggunakan antarmuka untuk mendapatkan informasi dasar produk trading di sini.
nilai nominal kontrak: ctVal, Kuantitas order minimum: minSz.
Apa format dari instId?
Anda dapat langsung menggunakan antarmuka untuk mendapatkan informasi dasar produk trading di sini.
Bagaimana cara mengatur SL dan TP?
Jika Order terpasang pada TP SL, Anda dapat merujuk ke antarmuka Order di sini: parameter array attachAlgoOrds.
Namun, jika itu adalah stop loss order terpisah, Anda dapat merujuk ke antarmuka komisi strategi di sini.
Mengapa terjadi kesalahan saat mengatur harga pemicu untuk TP dan SL: 51046, 51047, 51048, 51049?
Aturan untuk menetapkan harga pemicu stop-loss/harga pemicu take-profit – saat menjual, harga pemicu take-profit lebih tinggi dari harga transaksi terakhir, dan harga pemicu stop-loss lebih rendah dari harga transaksi terakhir; sedangkan saat membeli, harga pemicu take-profit lebih rendah dari harga transaksi terakhir, dan harga pemicu stop-loss lebih tinggi dari harga transaksi terakhir.
Apa itu "Interface error: 50102 Timestamp request expired"?
Kesalahan ini terjadi ketika cap waktu telah jatuh tempo. Anda perlu memanggil antarmuka waktu sistem di sini untuk menyinkronkan waktu lokal Anda dengan waktu server kami. Menjaga selisih waktu dalam 30 detik dapat membantu menghindari masalah ini.
Catatan: waktu pada header permintaan adalah dalam UTC0. Saat memanggil antarmuka waktu server, waktu disediakan dalam UTC + 8.
Apa arti "Interface error: 50101 APIKey does not match the current environment"?
Ini disebabkan oleh ketidakcocokan antara kunci API dan lingkungan saat ini. Panggilan akun nyata memerlukan penggunaan kunci API akun nyata, dan nilai parameter x-simulated-trading di header permintaan harus 0. Panggilan akun simulasi memerlukan penggunaan kunci API akun simulasi, dan nilai parameter x-simulated-trading di header permintaan harus 1.
Apa itu "Interface error: 51010 Request unsupported under current account mode"?
Ini terkait dengan Mode Akun Anda. Jika Anda ingin memasang leverage atau kontrak dengan satu Mata Uang, Anda perlu mengatur ke tiga mode lainnya kecuali Mode Spot! Anda dapat mengaturnya melalui pengaturan antarmuka di sini, atau Anda dapat mengaturnya di web atau aplikasi.
Catatan: pengaturan pertama harus diatur di halaman atau aplikasi; opsi pengaturan di menu utama halaman trading - Mode Akun.
Apa itu "Interface error: 51121 Order kuantitas harus kelipatan dari ukuran lot"?
Dalam API, order kontrak menggunakan satuan lembar dan harus kelipatan dari kuantitas order minimum pada pair mata uang. Kuantitas order minimum dapat diperoleh melalui field minSz pada antarmuka produk di sini.
"Kesalahan penarikan: 58207 Alamat Penarikan tidak ada dalam allowlist untuk pengecualian verifikasi"; mengapa verifikasi allowlist masih melaporkan kesalahan saat fitur ini ditutup di halaman penarikan?
Untuk tarik koin menggunakan antarmuka API, Anda perlu menambahkan Alamat Penarikan di halaman dan mencentang tombol non verified by visa. Apakah verifikasi Allowlist dimatikan di halaman tidak akan memengaruhi fungsi antarmuka.
Apa itu "Interface error: 50004 API endpoint request timeout" (tidak berarti permintaan berhasil atau gagal, silakan periksa hasil permintaan)?
50004 biasanya disebabkan oleh tekanan server yang berlebihan. Pukul 15.00, 23.00, dan 07.00 WIB adalah waktu pengumpulan biaya modal setiap hari. Pada waktu ini, tekanan server tinggi. Disarankan untuk menjadwalkan transaksi secara bergantian pada waktu tersebut. Jika kesalahan 50004 dilaporkan pada waktu lain, transaksi dapat dicoba ulang nanti. Jika Order ditempatkan dengan kesalahan 50004, itu tidak mewakili hasil sebenarnya dari permintaan antarmuka. Permintaan mungkin berhasil atau gagal. Harap merujuk pada hasil sebenarnya.
Apa itu kesalahan "50119 API key tidak ada"?
Kesalahan ini biasanya terjadi ketika domain akun Anda tidak sesuai dengan wilayah Anda.
Untuk Pengguna EEA, harap ubah nama domain permintaan API Anda menjadi eea.okx.com bukan www.okx.com.
Untuk Pengguna AS, silakan ubah nama domain permintaan API Anda menjadi us.okx.com bukan www.okx.com.
Jika Anda menggunakan perangkat lunak pihak ketiga untuk terhubung dengan OKX dan melihat kesalahan ini, harap periksa dengan penyedia perangkat lunak apakah mendukung domain regional. Misalnya, pengguna EEA harus terhubung melalui eea.okx.com, jika tidak permintaan akan gagal.
Mengapa muncul kesalahan "50110" saat menghubungkan ke perangkat lunak pihak ketiga?
Kesalahan ini dapat terjadi jika tipe kunci API saat ini tidak kompatibel dengan pengikatan perangkat lunak pihak ketiga. Cobalah mengajukan tipe transaksi kunci API, tanpa mengikat daftar IP, lalu sambungkan kembali perangkat lunak pihak ketiga tersebut.
Bagaimana cara mendapatkan harga transaksi terbaru dari pair mata uang tertentu?
Gunakan detail di sini untuk tickers dan untuk ticker, di sini. Antarmuka tickers digunakan untuk mendapatkan harga transaksi terbaru dari pair mata uang secara batch, dan ticker digunakan untuk mendapatkan harga transaksi terbaru dari pair mata uang individual.
Contoh parameter respons dari harga trading terakhir pada bagian Ticker
Apa saja persyaratan untuk membuat Kunci API?
Saldo Aset Kelolaan (AUM) minimum sebesar 100 USD diperlukan untuk membuat Kunci API.
AUM lebih dari 100 USD (AUM > 100U) diperlukan untuk membuat Kunci API
Untuk akun master atau Sub Akun, hanya akun dengan AUM > 100U yang diizinkan membuat API key
Catatan: Persyaratan ini hanya berlaku untuk pengguna di area tertentu
Apa yang harus saya lakukan jika WebSocket tidak dapat terhubung atau terus terputus?
Konfirmasikan bahwa Anda menggunakan URL WebSocket yang benar untuk situs dan layanan API Anda. Periksa jaringan, proxy, pengaturan TLS, parameter langganan, heartbeat Ping/Pong, dan logika penyambungan ulang. Jika masalah berlanjut, berikan saluran, waktu kejadian, pesan kesalahan lengkap, dan log yang telah disunting.
Bagaimana cara mengatasi kode kesalahan API atau parameter permintaan yang tidak valid?
Cari kode error di dokumentasi API resmi untuk situs Anda, lalu verifikasi titik akhir, metode HTTP, parameter permintaan, Mode Akun, dan pembatasan produk. Jika penyebabnya masih belum jelas, berikan kode error lengkap, sCode/sMsg, waktu kejadian, serta permintaan dan respons yang telah disunting.
Mengapa penempatan, perubahan, atau pembatalan Order API saya gagal?
Silakan gunakan pesan kesalahan dan kode kesalahan yang dikembalikan oleh API untuk menentukan penyebab spesifiknya. Jika Anda tidak yakin apa arti kesalahan tersebut, harap berikan parameter permintaan lengkap dan detail kesalahan agar kami dapat menyelidiki lebih lanjut.
Apa yang harus saya lakukan jika data pasar, candlestick, atau data daftar order terlihat tidak benar?
Konfirmasi nama saluran, instId, parameter langganan, dan frekuensi permintaan, serta bedakan data snapshot dari pembaruan inkremental. Untuk daftar order, juga verifikasi ID urutan dan cap waktu. Jika data tampak hilang, catat saluran, rentang waktu, dan respons mentah yang telah disunting.
Mengapa saldo API, posisi, atau nilai margin berbeda dari yang ada di situs web atau aplikasi?
Pertama, bedakan antara Akun Trading dan Akun Pendanaan, lalu verifikasi Mode Akun, dimensi Mata Uang, titik akhir, dan waktu pembaruan data. Untuk perhitungan Saldo, Posisi, dan Margin, gunakan dokumentasi produk dan API terbaru untuk situs yang berlaku.
Apa yang harus saya lakukan jika deposit, penarikan, atau transfer API gagal?
Periksa izin API, mata uang, jaringan, akun tujuan, serta persyaratan buku alamat atau daftar putih, lalu selesaikan masalah menggunakan kode kesalahan yang dikembalikan. Pembatasan keamanan akun, kepatuhan, atau risiko mungkin memerlukan tinjauan lebih lanjut oleh dukungan untuk situs yang berlaku.
Bagaimana cara membuat dan menggunakan Kunci API untuk Sub Akun?
Buat Kunci API di bawah Sub Akun yang dimaksud dan gunakan izin, Passphrase, serta domain situs Sub Akun tersebut. Jangan mencampur Kunci API, Secret, atau Passphrase Akun induk dengan Sub Akun.
Apa yang harus saya lakukan setelah memicu batas laju API?
Kurangi laju permintaan sesuai dengan batas untuk titik akhir tertentu, dan gunakan antrean permintaan, exponential backoff, atau titik akhir batch jika sesuai. Ruang lingkup dan kuota pembatasan laju dapat berbeda-beda untuk setiap titik akhir, jadi jangan menganggap semua titik akhir memiliki batas yang sama.
Di mana saya bisa menemukan dokumentasi API, SDK, dan contoh kode?
Anda dapat memeriksa Dokumentasi API (V5). Referensi REST + WebSocket, changelog, kode kesalahan, contoh permintaan/respons per titik akhir. SDK resmi (GitHub) — github.com/okxapi Contoh kode dapat ditemukan di SDK.
Informasi apa yang harus saya berikan jika saya hanya bisa mengatakan “API tidak berfungsi”?
Berikan titik akhir, metode HTTP, operasi yang dimaksud, kode atau pesan kesalahan lengkap, waktu kejadian, situs akun, lingkungan jaringan, serta permintaan dan respons yang telah disunting. Jangan pernah mengirimkan API Secret, Passphrase, kode verifikasi, atau tanda tangan yang belum disunting.
Apa yang harus saya lakukan jika saya masih memiliki Pertanyaan API? Atau bisakah saya mengobrol dengan CS API?
Jika Anda memiliki pertanyaan lebih lanjut, silakan bergabung dengan grup dukungan API kami:
Apa yang harus saya lakukan jika API Simulasi Trading mengembalikan kode kesalahan 50123?
Kode error 50123 berarti Kunci API tidak memiliki izin untuk trading kripto. Untuk Simulasi Trading, gunakan Kunci API yang dibuat di bawah Simulasi Trading, pastikan kunci tersebut memiliki izin Trade, gunakan domain API yang benar untuk situs Anda, dan sertakan x-simulated-trading: 1 di setiap permintaan simulated-trading. Kunci dengan izin hanya Read dapat mengambil data akun tetapi tidak dapat melakukan Order.
Apa yang harus saya lakukan jika Order Spot Demo mengembalikan HTTP 503 dan kode error OKX 50001?
Kode error 50001 dengan HTTP 503 berarti layanan sedang tidak tersedia sementara. Silakan coba lagi nanti. Jika error terus terjadi, bergabunglah dengan grup dukungan API kami untuk menghubungi CS API.
Catatan:
Jika Anda memiliki pertanyaan tentang WebSocket atau topik terkait API lainnya, klik tautan artikel dan pindai kode QR di bagian bawah artikel menggunakan Aplikasi OKX untuk bergabung dengan grup dan menghubungi spesialis dukungan API kami.
Cara memindai: di aplikasi, ketuk Menu > ikon Scan, lalu pindai kode QR.