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 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?
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 pesanan kontrak, antarmuka secara default menggunakan pesanan 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 mereka 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 tickers dan untuk ticker, di sini. Antarmuka tickers digunakan untuk mendapatkan harga transaksi terbaru dari pasangan Mata Uang secara batch, dan ticker digunakan untuk mendapatkan harga transaksi terbaru dari pasangan Mata Uang individual.
Contoh parameter respons dari harga trading terakhir pada bagian Tickers
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
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.