Sebelum sesebuah bot dapat berdagang untuk anda, Freya memerlukan sambungan ke exchange tempat dana anda berada — Binance, OKX, atau Bybit. Anda tidak memindahkan dana atau berkongsi kata laluan untuk melakukan ini. Sebaliknya, anda mencipta sebuah API key: satu kelayakan terhad yang membenarkan Freya membuat dagangan bagi pihak anda, sementara wang anda kekal di dalam akaun exchange anda sendiri.
Panduan ini menerangkan dengan tepat kebenaran mana yang perlu diberikan (dan mana yang tidak boleh sama sekali), cara menambah key ke Freya, dan apa yang perlu dilakukan jika sambungan tidak disahkan. Jika anda ingin memahami gambaran besar mengapa ini selamat, baca dahulu Adakah Wang Saya Selamat di Freya Finance?.
Perkara Utama
- Anda menghubungkan exchange dengan API key — satu kelayakan terhad — bukan dengan memindahkan dana atau berkongsi kata laluan exchange anda.
- Key memerlukan kebenaran Reading serta dagangan Spot dan/atau Futures. Key TIDAK BOLEH SEKALI-KALI mempunyai kebenaran pengeluaran.
- Key OKX memerlukan passphrase yang anda tetapkan semasa menciptanya; Binance dan Bybit tidak.
- Tambah key di Freya melalui Tetapan → API Keys → Tambah API Key, dan Freya mengesahkannya serta-merta.
- Jika pengesahan gagal, Freya memberitahu anda dengan tepat sebabnya — key tidak sah, IP tidak di-whitelist, atau kebenaran yang hilang — dan setiap satu mempunyai penyelesaian yang mudah.
Ringkasan Ringkas Langkah-Langkahnya
- Cipta satu API key di exchange anda dengan kebenaran baca dan dagangan, tetapi tanpa pengeluaran.
- Salin kelayakannya — API key, secret, dan (untuk OKX) passphrase.
- Tambah key ke Freya melalui Tetapan → API Keys → Tambah API Key, kemudian pilih exchange anda.
- Biarkan Freya mengesahkannya — Freya menyemak sambungan dan kebenaran dengan serta-merta.
- Betulkan sebarang ralat yang dilaporkan — Freya memberitahu anda dengan tepat apa yang salah jika pengesahan gagal.
Apa Itu API Key — dan Kebenaran Mana yang Freya Perlukan
API key ialah sepasang kelayakan (sebuah key dan sebuah secret) yang membenarkan satu aplikasi berkomunikasi dengan akaun exchange anda secara terhad. Anda yang menentukan apa yang boleh dilakukan oleh key tersebut. Untuk Freya, aktifkan hanya:
- Reading — supaya Freya dapat melihat baki, posisi, dan status pesanan anda.
- Dagangan Spot dan/atau dagangan Futures — supaya bot anda dapat membuat pesanan yang diperlukannya. Aktifkan yang sepadan dengan bot yang anda rancang untuk jalankan.
Freya membuat dagangan; ia tidak pernah perlu memindahkan wang keluar dari akaun anda. Sentiasa biarkan kebenaran pengeluaran dinyahaktifkan pada key yang anda hubungkan. Ini adalah kebenaran yang anda kawal di exchange — dengan ia dimatikan, baik Freya mahupun sesiapa yang mungkin memperoleh key tersebut tidak dapat mengeluarkan dana anda. Ini adalah tabiat paling penting dalam menghubungkan mana-mana platform bot.
Langkah 1: Cipta Satu API Key di Exchange Anda
Di bahagian API management exchange anda, cipta satu API key baharu:
- Binance — cipta key di API Management, aktifkan reading serta dagangan Spot dan/atau Futures, dan biarkan pengeluaran dimatikan.
- OKX — cipta key dan tetapkan satu passphrase (anda akan memerlukannya di Freya); aktifkan reading dan dagangan, bukan pengeluaran.
- Bybit — cipta key dengan kebenaran baca dan dagangan untuk produk yang akan anda gunakan, dan biarkan pengeluaran dimatikan.
Jika exchange anda menawarkan IP whitelisting, amalan yang baik adalah mengehadkan key hanya kepada alamat IP Freya. Jika anda berbuat demikian, pastikan anda mem-whitelist IP Freya, atau sambungan akan ditolak (lihat jadual ralat di bawah).
Semasa anda mencipta key, exchange memaparkan secret sekali sahaja. Salin dengan segera dan simpan dengan selamat. Jika anda kehilangannya, anda tidak dapat memulihkannya — anda perlu memadam key tersebut dan mencipta yang baharu.
Langkah 2: Tambah Key ke Freya
Di Freya, buka Tetapan → API Keys kemudian pilih Tambah API Key. Selepas itu:
- Pilih exchange anda (Binance, OKX, atau Bybit).
- Tampal API key dan secret. Untuk OKX, masukkan juga passphrase yang anda tetapkan.
- Beri nama pada key supaya anda dapat mengenalinya kemudian.
Anda boleh menghubungkan lebih daripada satu exchange, serta mengurus atau memadam key anda dari halaman yang sama ini pada bila-bila masa.
Langkah 3: Freya Mengesahkan Key Anda
Sebaik sahaja anda menambah key, Freya menyemak sambungan dan kebenarannya — tanpa perlu meneka. Jika semuanya betul, key disahkan dan sedia untuk digunakan. Jika ada yang salah, Freya memaparkan mesej yang jelas menerangkan dengan tepat apa yang perlu dibetulkan.
Memahami Ralat Pengesahan
Jika pengesahan gagal, padankan mesej yang Freya paparkan dengan penyelesaian di bawah:
| Apa yang Freya paparkan | Apa maksudnya | Cara membetulkannya |
|---|---|---|
| API Key Tidak Sah | Key disalin dengan salah atau dipadam di exchange | Salin semula API key dengan tepat, atau cipta yang baharu |
| Secret Key Tidak Sah | Secret tidak sepadan dengan key | Salin semula secret; jika anda kehilangannya, cipta key baharu |
| Alamat IP Tidak Di-whitelist | Key dihadkan kepada IP tertentu dan alamat Freya tidak dibenarkan | Whitelist IP Freya pada key, atau buang sekatan IP |
| Kebenaran Hilang | Key tidak mempunyai kebenaran baca atau dagangan | Aktifkan reading serta dagangan Spot/Futures pada key |
| Kebenaran Baca Dinyahaktifkan | Freya tidak dapat membaca akaun anda | Aktifkan kebenaran read/view pada key |
| Kebenaran Spot/Futures Dinyahaktifkan | Key tidak dapat membuat pesanan yang diperlukan bot anda | Aktifkan jenis dagangan (Spot atau Futures) yang sepadan dengan bot anda |
| Sambungan Gagal | Masalah rangkaian atau exchange yang bersifat sementara | Tunggu sebentar dan cuba tambah key sekali lagi |
Freya juga akan menandakan key yang berada dalam mod “Unrestricted” — bermakna key tersebut tidak mempunyai sekatan IP. Demi keselamatan anda, Freya meminta anda untuk menghidupkan sekatan IP dan menambah alamat yang dipaparkannya sebelum key dapat disimpan. Aktifkan hanya reading dan dagangan (jangan sekali-kali pengeluaran), dan hadkan key kepada IP Freya. (Maklumat lanjut tentang ralat sambungan di Tidak Dapat Menghubungkan Exchange Anda?.)
Nota tentang Keselamatan
Sambungan ini selamat secara reka bentuk, tetapi beberapa tabiat mengekalkannya sedemikian:
- Pengeluaran dimatikan, sentiasa — Freya tidak pernah memerlukannya.
- Gunakan IP whitelisting apabila exchange anda menyokongnya.
- Satu key, satu tujuan — dan padam key yang tidak lagi anda gunakan.
Untuk gambaran lengkap tentang bagaimana dana dan key anda dilindungi, lihat Adakah Wang Saya Selamat di Freya Finance? dan Keselamatan API Exchange & Mitigasi Risiko.
Soalan Lazim
Kebenaran mana yang Freya perlukan pada API key saya?
Reading (untuk melihat baki, posisi, dan pesanan anda) serta dagangan Spot dan/atau Futures (untuk membuat pesanan bot anda). Aktifkan jenis dagangan yang sepadan dengan bot yang akan anda jalankan. Freya tidak pernah memerlukan kebenaran pengeluaran, jadi sentiasa biarkan kebenaran itu dinyahaktifkan.
Adakah Freya memerlukan kebenaran untuk mengeluarkan dana saya?
Tidak. Freya hanya membuat dan mengurus dagangan; ia tidak boleh dan tidak sepatutnya dapat memindahkan dana keluar dari exchange anda. Sentiasa biarkan kebenaran pengeluaran dimatikan pada key yang anda hubungkan — ini adalah kebenaran yang anda kawal di exchange.
Mengapa Freya memaparkan “Alamat IP Tidak Di-whitelist”?
API key anda dihadkan kepada alamat IP tertentu, dan alamat Freya tidak ada dalam senarai. Sama ada tambahkan alamat IP Freya ke whitelist key di exchange anda, atau buang sekatan IP daripada key tersebut. Selepas mengemas kininya, tambah semula key di Freya.
Mengapa muncul “API Key Tidak Sah” atau “Secret Key Tidak Sah”?
Biasanya key atau secret disalin dengan salah, atau key dipadam atau dijana semula di exchange. Salin semula kedua-dua nilai tersebut dengan tepat. Oleh sebab secret hanya dipaparkan sekali semasa anda mencipta key, jika anda tidak lagi memilikinya, padam key di exchange dan cipta yang baharu.
Apa itu passphrase, dan mengapa OKX memintanya?
API key OKX menyertakan passphrase yang anda tetapkan sendiri semasa mencipta key — ia adalah kelayakan tambahan di samping key dan secret. Masukkan passphrase yang sama di Freya semasa menambah key OKX. Binance dan Bybit tidak menggunakan passphrase.
Bolehkah saya menghubungkan lebih daripada satu exchange?
Ya. Anda boleh menambah API key untuk Binance, OKX, dan Bybit, serta mengurus atau memadamnya pada bila-bila masa dari Tetapan → API Keys.
Adakah selamat untuk memberikan API key saya kepada Freya?
Ya, apabila key disediakan dengan betul — reading dan dagangan sahaja, tanpa pengeluaran, dan di-whitelist IP jika boleh. Dana anda kekal di exchange anda sendiri, dan key yang anda kongsi tidak dapat memindahkannya. Untuk penjelasan lengkap, lihat Adakah Wang Saya Selamat di Freya Finance?.
Exchange mana yang disokong oleh Freya?
Freya pada masa ini menyambung ke Binance, OKX, dan Bybit (spot dan futures). Lebih banyak exchange mungkin ditambah dari semasa ke semasa. Anda berdagang di exchange mana pun yang anda hubungkan — dana anda dan pasaran yang tersedia kekal di exchange tersebut.
Koin atau pasangan dagangan mana yang boleh saya dagangkan?
Pasangan yang tersedia berasal daripada senarai exchange yang anda hubungkan sendiri, bukan senarai Freya yang berasingan — jadi jika exchange anda menyenaraikan sesuatu pasangan (cth. BTC/USDT, ETH/USDT), anda boleh membina bot padanya. Kebanyakan dagangan dilakukan terhadap USDT sebagai mata wang quote. Jika sesuatu exchange men-delist sesuatu pasangan, pasangan tersebut berhenti daripada boleh didagangkan di sana.