Sebelum sebuah bot dapat melakukan trading untuk Anda, Freya membutuhkan koneksi ke exchange tempat dana Anda berada — Binance, OKX, atau Bybit. Anda tidak memindahkan dana atau membagikan kata sandi untuk melakukan ini. Sebagai gantinya, Anda membuat sebuah API key: sebuah kredensial terbatas yang memungkinkan Freya menempatkan trade atas nama Anda, sementara uang Anda tetap berada di akun exchange Anda sendiri.
Panduan ini menjelaskan secara persis izin mana yang harus diberikan (dan mana yang tidak boleh sama sekali), cara menambahkan key ke Freya, dan apa yang harus dilakukan jika koneksi tidak tervalidasi. Jika Anda ingin memahami gambaran besar mengapa ini aman, baca dulu Apakah Uang Saya Aman di Freya Finance?.
Poin Penting
- Anda menghubungkan exchange dengan API key — sebuah kredensial terbatas — bukan dengan memindahkan dana atau membagikan kata sandi exchange Anda.
- Key membutuhkan izin Reading serta Spot dan/atau Futures trading. Key TIDAK BOLEH memiliki izin penarikan.
- Key OKX membutuhkan passphrase yang Anda tetapkan saat membuatnya; Binance dan Bybit tidak.
- Tambahkan key di Freya melalui Pengaturan → API Keys → Tambah API Key, dan Freya memvalidasinya secara instan.
- Jika validasi gagal, Freya memberi tahu Anda persis alasannya — key tidak valid, IP tidak di-whitelist, atau izin yang hilang — dan masing-masing punya perbaikan sederhana.
Ringkasan Cepat Langkah-Langkahnya
- Buat API key di exchange Anda dengan izin baca dan trading, tetapi tanpa penarikan.
- Salin kredensialnya — API key, secret, dan (untuk OKX) passphrase.
- Tambahkan key ke Freya melalui Pengaturan → API Keys → Tambah API Key, lalu pilih exchange Anda.
- Biarkan Freya memvalidasinya — Freya memeriksa koneksi dan izin secara langsung.
- Perbaiki setiap error yang dilaporkan — Freya memberi tahu Anda persis apa yang salah jika validasi gagal.
Apa Itu API Key — dan Izin Mana yang Freya Butuhkan
API key adalah sepasang kredensial (sebuah key dan sebuah secret) yang memungkinkan satu aplikasi berkomunikasi dengan akun exchange Anda secara terbatas. Anda yang memutuskan apa yang boleh dilakukan key tersebut. Untuk Freya, aktifkan hanya:
- Reading — agar Freya dapat melihat saldo, posisi, dan status order Anda.
- Spot trading dan/atau Futures trading — agar bot Anda dapat menempatkan order yang dibutuhkannya. Aktifkan yang sesuai dengan bot yang berencana Anda jalankan.
Freya menempatkan trade; Freya tidak pernah perlu memindahkan uang keluar dari akun Anda. Selalu biarkan izin penarikan dinonaktifkan pada key yang Anda hubungkan. Ini adalah izin yang Anda kendalikan di exchange — dengan izin ini mati, baik Freya maupun siapa pun yang mungkin memperoleh key tersebut tidak dapat menarik dana Anda. Ini adalah kebiasaan paling penting dalam menghubungkan platform bot mana pun.
Langkah 1: Buat API Key di Exchange Anda
Di bagian API management exchange Anda, buat sebuah API key baru:
- Binance — buat key di API Management, aktifkan reading serta Spot dan/atau Futures trading, dan biarkan penarikan mati.
- OKX — buat key dan tetapkan sebuah passphrase (Anda akan membutuhkannya di Freya); aktifkan reading dan trading, bukan penarikan.
- Bybit — buat key dengan izin baca dan trade untuk produk yang akan Anda gunakan, dan biarkan penarikan mati.
Jika exchange Anda menawarkan IP whitelisting, praktik yang baik adalah membatasi key hanya ke alamat IP Freya. Jika Anda melakukannya, pastikan untuk mem-whitelist IP Freya, atau koneksi akan ditolak (lihat tabel error di bawah).
Saat Anda membuat key, exchange menampilkan secret satu kali saja. Salin segera dan simpan dengan aman. Jika Anda kehilangannya, Anda tidak dapat memulihkannya — Anda harus menghapus key tersebut dan membuat yang baru.
Langkah 2: Tambahkan Key ke Freya
Di Freya, buka Pengaturan → API Keys lalu pilih Tambah API Key. Kemudian:
- Pilih exchange Anda (Binance, OKX, atau Bybit).
- Tempel API key dan secret. Untuk OKX, masukkan juga passphrase yang Anda tetapkan.
- Beri nama pada key agar Anda dapat mengenalinya nanti.
Anda dapat menghubungkan lebih dari satu exchange, serta mengelola atau menghapus key Anda dari halaman yang sama ini kapan saja.
Langkah 3: Freya Memvalidasi Key Anda
Segera setelah Anda menambahkan key, Freya memeriksa koneksi dan izinnya — tanpa perlu menebak-nebak. Jika semuanya benar, key terverifikasi dan siap digunakan. Jika ada yang salah, Freya menampilkan pesan yang jelas menjelaskan persis apa yang harus diperbaiki.
Memahami Error Validasi
Jika validasi gagal, cocokkan pesan yang Freya tampilkan dengan perbaikan di bawah ini:
| Apa yang Freya tampilkan | Apa artinya | Cara memperbaikinya |
|---|---|---|
| API Key Tidak Valid | Key disalin dengan salah atau dihapus di exchange | Salin ulang API key persis, atau buat yang baru |
| Secret Key Tidak Valid | Secret tidak cocok dengan key | Salin ulang secret; jika Anda kehilangannya, buat key baru |
| Alamat IP Tidak Di-whitelist | Key dibatasi ke IP tertentu dan alamat Freya tidak diizinkan | Whitelist IP Freya pada key, atau hapus pembatasan IP |
| Izin Hilang | Key tidak memiliki izin baca atau trading | Aktifkan reading serta Spot/Futures trading pada key |
| Izin Baca Dinonaktifkan | Freya tidak dapat membaca akun Anda | Aktifkan izin read/view pada key |
| Izin Spot/Futures Dinonaktifkan | Key tidak dapat menempatkan order yang dibutuhkan bot Anda | Aktifkan tipe trading (Spot atau Futures) yang sesuai dengan bot Anda |
| Koneksi Gagal | Masalah jaringan atau exchange yang bersifat sementara | Tunggu sejenak dan coba tambahkan key lagi |
Freya juga akan menandai key yang berada dalam mode “Unrestricted” — artinya key tersebut tidak memiliki pembatasan IP. Demi keamanan Anda, Freya meminta Anda untuk mengaktifkan pembatasan IP dan menambahkan alamat yang ditampilkannya sebelum key dapat disimpan. Aktifkan hanya reading dan trading (jangan pernah penarikan), dan batasi key ke IP Freya. (Selengkapnya tentang error koneksi di Tidak Bisa Menghubungkan Exchange Anda?.)
Catatan tentang Keamanan
Koneksi ini aman secara desain, tetapi beberapa kebiasaan menjaganya tetap demikian:
- Penarikan mati, selalu — Freya tidak pernah membutuhkannya.
- Gunakan IP whitelisting saat exchange Anda mendukungnya.
- Satu key, satu tujuan — dan hapus key yang tidak lagi Anda gunakan.
Untuk gambaran lengkap tentang bagaimana dana dan key Anda dilindungi, lihat Apakah Uang Saya Aman di Freya Finance? dan Keamanan API Exchange & Mitigasi Risiko.
Pertanyaan yang Sering Diajukan
Izin mana yang Freya butuhkan pada API key saya?
Reading (untuk melihat saldo, posisi, dan order Anda) serta Spot dan/atau Futures trading (untuk menempatkan order bot Anda). Aktifkan tipe trading yang sesuai dengan bot yang akan Anda jalankan. Freya tidak pernah membutuhkan izin penarikan, jadi selalu biarkan izin itu dinonaktifkan.
Apakah Freya membutuhkan izin untuk menarik dana saya?
Tidak. Freya hanya menempatkan dan mengelola trade; Freya tidak bisa dan tidak seharusnya dapat memindahkan dana keluar dari exchange Anda. Selalu biarkan izin penarikan mati pada key yang Anda hubungkan — ini adalah izin yang Anda kendalikan di exchange.
Mengapa Freya menampilkan “Alamat IP Tidak Di-whitelist”?
API key Anda dibatasi ke alamat IP tertentu, dan alamat Freya tidak ada dalam daftar. Entah tambahkan alamat IP Freya ke whitelist key di exchange Anda, atau hapus pembatasan IP dari key tersebut. Setelah memperbaruinya, tambahkan lagi key di Freya.
Mengapa muncul “API Key Tidak Valid” atau “Secret Key Tidak Valid”?
Biasanya key atau secret disalin dengan salah, atau key dihapus atau dibuat ulang di exchange. Salin ulang kedua nilai tersebut persis. Karena secret hanya ditampilkan sekali saat Anda membuat key, jika Anda tidak lagi memilikinya, hapus key di exchange dan buat yang baru.
Apa itu passphrase, dan mengapa OKX memintanya?
API key OKX menyertakan passphrase yang Anda tetapkan sendiri saat membuat key — ini adalah kredensial tambahan di samping key dan secret. Masukkan passphrase yang sama di Freya saat menambahkan key OKX. Binance dan Bybit tidak menggunakan passphrase.
Bisakah saya menghubungkan lebih dari satu exchange?
Ya. Anda dapat menambahkan API key untuk Binance, OKX, dan Bybit, serta mengelola atau menghapusnya kapan saja dari Pengaturan → API Keys.
Apakah aman memberikan API key saya ke Freya?
Ya, ketika key disiapkan dengan benar — reading dan trading saja, tanpa penarikan, dan di-whitelist IP jika memungkinkan. Dana Anda tetap berada di exchange Anda sendiri, dan key yang Anda bagikan tidak dapat memindahkannya. Untuk penjelasan lengkap, lihat Apakah Uang Saya Aman di Freya Finance?.
Exchange mana yang didukung Freya?
Freya saat ini terhubung ke Binance, OKX, dan Bybit (spot dan futures). Lebih banyak exchange mungkin ditambahkan seiring waktu. Anda melakukan trading di exchange mana pun yang Anda hubungkan — dana Anda dan pasar yang tersedia tetap berada di exchange tersebut.
Koin atau trading pair mana yang bisa saya perdagangkan?
Pair yang tersedia berasal dari listing exchange yang Anda hubungkan sendiri, bukan daftar Freya yang terpisah — jadi jika exchange Anda mencantumkan sebuah pair (mis. BTC/USDT, ETH/USDT), Anda dapat membangun bot di atasnya. Sebagian besar trading dilakukan terhadap USDT sebagai mata uang quote. Jika sebuah exchange men-delist sebuah pair, pair tersebut berhenti dapat diperdagangkan di sana.