Pertanyaan yang Sering Diajukan (FAQ) API OKX
Apa yang dimaksud dengan Passphrase?
Ini adalah kata sandi yang Anda isi saat mengajukan Kunci API. Anda perlu 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 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 diwajibkan untuk 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 kunci API yang sudah ada. Klik pada kunci 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 akun dan pengaturan 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?
Kunci API yang tidak terikat pada IP dan memiliki izin transaksi atau penarikan akan secara otomatis dihapus setelah 14 hari tidak aktif. Kunci API tidak akan dianggap tidak aktif jika digunakan untuk memanggil antarmuka pribadi atau terkait akun yang memerlukan Verifikasi Identitas, seperti melihat Saldo Akun, data penagihan, atau melakukan pemesanan.
Hanya kunci API dengan izin baca saja yang terikat pada IP atau izin tertentu yang tidak akan kedaluwarsa.
Apa itu izin Loan, Earn, dan Transfer?
Transfer: Memungkinkan kunci untuk melakukan transfer dana antar akun Anda. Tersedia untuk semua akun.
Loan: Memungkinkan pengguna untuk meminjam, melunasi, dan mengelola Loan. Hanya terlihat jika akun Anda memenuhi syarat fitur yang diperlukan.
Earn: Memungkinkan kunci untuk berlangganan dan mencairkan produk Earn. 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 pesanan dapat dilakukan dalam satuan mata uang saat melakukan pemesanan 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.
Kenaikan dan penurunan nilai harga transaksi terbaru dibandingkan dengan harga pembukaan K-line 24 jam yang lalu/100% dari harga pembukaan K-line 24 jam yang lalu.
Data rumus di atas dapat diperoleh melalui antarmuka pasar di sini.
Apa penyebab munculnya pesan kesalahan "51000 Parameter posSide error" saat melakukan order?
Anda perlu memeriksa mode akun terlebih dahulu; mode beli dan jual/mode buka dan tutup, 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 dalam mode pembukaan dan penutupan, posSide hanya mendukung net atau tidak ada transmisi.
Antarmuka mana yang dapat digunakan untuk memperoleh nilai nominal kontrak dan kuantitas order minimum?
Anda dapat menggunakan antarmuka untuk mendapatkan informasi dasar tentang 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 "Kesalahan Antarmuka: 50102 Permintaan timestamp telah jatuh tempo"?
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 itu "Kesalahan antarmuka: 50101 APIKey tidak cocok dengan lingkungan saat ini"?
Ini disebabkan oleh ketidaksesuaian antara kunci API dan lingkungan saat ini. Panggilan akun nyata memerlukan penggunaan kunci API akun nyata, dan nilai parameter x-simulated-trading dalam header permintaan harus 0. Panggilan akun simulasi memerlukan penggunaan kunci API akun simulasi, dan nilai parameter x-simulated-trading dalam header permintaan harus 1.
Apa itu "Kesalahan antarmuka: 51010 Permintaan tidak didukung dalam mode akun saat ini"?
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 quantity must be a multiple of the lot size"?
Dalam API, order kontrak menggunakan satuan lembar dan harus merupakan 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 meskipun sudah ditutup di halaman penarikan?
Untuk menarik koin menggunakan antarmuka API, 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 arti "Interface error: 50004 API endpoint request timeout" (tidak berarti permintaan berhasil atau gagal, harap periksa hasil permintaan)?
50004 biasanya disebabkan oleh tekanan server yang berlebihan. Pukul 8, 16, dan 24 adalah waktu pengumpulan biaya modal setiap hari. Pada waktu ini, tekanan server tinggi. Disarankan untuk mengatur transaksi agar tidak bersamaan pada waktu-waktu tersebut. Jika terjadi kesalahan 50004 pada waktu lain, dapat dicoba kembali nanti. Jika sebuah order ditempatkan dengan kesalahan 50004, itu tidak mewakili hasil sebenarnya dari permintaan antarmuka. Permintaan tersebut mungkin berhasil atau gagal. Harap merujuk pada hasil sebenarnya.
Apa itu error "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, harap 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 mungkin terjadi jika tipe kunci API saat ini tidak kompatibel dengan pengikatan perangkat lunak pihak ketiga. Cobalah untuk 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 Ticker dan untuk Ticker, lihat di sini. Antarmuka Ticker 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 persyaratan untuk membuat Kunci API?
Saldo minimum Aset yang Dikelola (AUM) 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 kunci API
Catatan: Persyaratan ini hanya berlaku untuk pengguna di area tertentu
Apa yang harus saya lakukan jika WebSocket tidak dapat terhubung atau terus terputus?
Pastikan 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 kesalahan 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 kesalahan 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 bersangkutan.
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 dari Sub Akun tersebut. Jangan mencampur Kunci API, Secret, atau Passphrase antara akun induk dan Sub Akun.
Apa yang harus saya lakukan setelah memicu batas kecepatan API?
Kurangi laju permintaan sesuai dengan batas untuk titik akhir tertentu, dan gunakan antrean permintaan, penundaan eksponensial, atau titik akhir batch jika diperlukan. 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 merujuk ke 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:
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.