Bago makapag-trade ang isang bot para sa iyo, kailangan ng Freya ng koneksyon sa exchange kung saan nakalagay ang iyong pondo — Binance, OKX, o Bybit. Hindi mo inililipat ang pondo mo o ibinabahagi ang password mo para dito. Sa halip, gumagawa ka ng isang API key: isang limitadong credential na nagpapahintulot sa Freya na maglagay ng mga trade para sa iyo, habang ang pera mo ay nananatili sa sarili mong exchange account.
Ipinapaliwanag ng gabay na ito nang eksakto kung anong permissions ang dapat ibigay (at kung alin ang hindi kailanman dapat), kung paano idagdag ang key sa Freya, at kung ano ang gagawin kapag hindi na-validate ang koneksyon. Kung gusto mo ng mas malaking larawan kung bakit ligtas ito, basahin muna ang Ligtas Ba ang Pera Ko sa Freya Finance?.
Mahahalagang Punto
- Ikinokonekta mo ang isang exchange gamit ang API key — isang limitadong credential — hindi sa pamamagitan ng paglilipat ng pondo o pagbabahagi ng password ng iyong exchange.
- Kailangan ng key ang Reading at Spot at/o Futures trading permissions. HINDI ito dapat magkaroon kailanman ng withdrawal permission.
- Ang mga OKX key ay nangangailangan ng passphrase na itinatakda mo kapag ginagawa ang mga ito; hindi naman kailangan ng Binance at Bybit.
- Idagdag ang key sa Freya sa ilalim ng Mga Setting → API Keys → Magdagdag ng API Key, at ito ay agad na vi-validate ng Freya.
- Kapag nabigo ang validation, sasabihin sa iyo ng Freya kung bakit nang eksakto — invalid na key, hindi naka-whitelist na IP, o kulang na permission — at bawat isa ay may simpleng ayos.
Mabilisang Buod ng mga Hakbang
- Gumawa ng API key sa iyong exchange na may reading at trading permissions, ngunit walang withdrawal.
- Kopyahin ang mga credential — ang API key, ang secret, at (para sa OKX) ang passphrase.
- Idagdag ang key sa Freya sa ilalim ng Mga Setting → API Keys → Magdagdag ng API Key, at piliin ang iyong exchange.
- Hayaang i-validate ito ng Freya — agad na sinusuri ng Freya ang koneksyon at ang mga permission.
- Ayusin ang anumang error na iu-ulat nito — sinasabi sa iyo ng Freya nang eksakto kung ano ang mali kapag nabigo ang validation.
Ano ang API Key — at Kung Anong mga Permission ang Kailangan ng Freya
Ang API key ay isang pares ng credential (isang key at isang secret) na nagpapahintulot sa isang app na makipag-usap sa iyong exchange account sa limitadong paraan. Ikaw ang nagpapasya kung ano ang pinapayagang gawin ng key na iyon. Para sa Freya, i-enable lamang ang:
- Reading — para makita ng Freya ang iyong mga balance, posisyon, at status ng order.
- Spot trading at/o Futures trading — para makapaglagay ang bot mo ng mga order na kailangan nito. I-enable kung alin ang tumutugma sa mga bot na balak mong patakbuhin.
Naglalagay ng trade ang Freya; hindi nito kailanman kailangang maglipat ng pera palabas ng iyong account. Palaging iwanang naka-disable ang withdrawal permission sa key na ikinokonekta mo. Ito ay isang permission na ikaw ang may kontrol sa exchange — kapag naka-off ito, hindi maaaring i-withdraw ang pondo mo ng Freya o ng sinumang maaaring makakuha ng key. Ito ang pinakamahalagang gawi sa pagkonekta sa anumang bot platform.
Hakbang 1: Gumawa ng API Key sa Iyong Exchange
Sa API management section ng iyong exchange, gumawa ng bagong API key:
- Binance — gawin ang key sa ilalim ng API Management, i-enable ang reading at Spot at/o Futures trading, at iwanang naka-off ang withdrawals.
- OKX — gawin ang key at magtakda ng passphrase (kakailanganin mo ito sa Freya); i-enable ang reading at trading, hindi ang withdrawals.
- Bybit — gawin ang key na may read at trade permissions para sa mga produktong gagamitin mo, at iwanang naka-off ang withdrawals.
Kung nag-aalok ang exchange mo ng IP whitelisting, magandang gawi na limitahan ang key sa mga IP address ng Freya. Kung gagawin mo ito, siguraduhing i-whitelist ang mga IP ng Freya, o kaya ay tatanggihan ang koneksyon (tingnan ang talahanayan ng mga error sa ibaba).
Kapag ginawa mo ang key, minsan lang ipinapakita ng exchange ang secret. Kopyahin ito agad at itago nang ligtas. Kapag nawala mo ito, hindi mo na ito mababawi — kailangan mong burahin ang key at gumawa ng bago.
Hakbang 2: Idagdag ang Key sa Freya
Sa Freya, pumunta sa Mga Setting → API Keys at piliin ang Magdagdag ng API Key. Pagkatapos:
- Piliin ang iyong exchange (Binance, OKX, o Bybit).
- I-paste ang API key at secret. Para sa OKX, ilagay din ang passphrase na itinakda mo.
- Bigyan ng pangalan ang key para makilala mo ito mamaya.
Maaari kang magkonekta ng higit sa isang exchange, at i-manage o burahin ang iyong mga key mula sa parehong pahinang ito anumang oras.
Hakbang 3: Vi-validate ng Freya ang Iyong Key
Sa sandaling maidagdag mo ang key, sinusuri ng Freya ang koneksyon at ang mga permission — walang hula-hula. Kung tama ang lahat, ang key ay verified at handa nang gamitin. Kung may mali, nagpapakita ang Freya ng malinaw na mensahe na nagpapaliwanag nang eksakto kung ano ang aayusin.
Pag-unawa sa mga Validation Error
Kapag nabigo ang validation, itugma ang mensaheng ipinapakita ng Freya sa ayos sa ibaba:
| Ano ang ipinapakita ng Freya | Ano ang ibig sabihin nito | Paano ito ayusin |
|---|---|---|
| Invalid API Key | Mali ang pagkakakopya ng key o binura ito sa exchange | Kopyahin muli ang API key nang eksakto, o gumawa ng bago |
| Invalid Secret Key | Hindi tumutugma ang secret sa key | Kopyahin muli ang secret; kung nawala mo ito, gumawa ng bagong key |
| IP Address Not Whitelisted | Naka-restrict sa IP ang key at hindi pinapayagan ang address ng Freya | I-whitelist ang mga IP ng Freya sa key, o alisin ang IP restriction |
| Missing Permissions | Walang reading o trading permission ang key | I-enable ang reading at Spot/Futures trading sa key |
| Reading Permission Disabled | Hindi mabasa ng Freya ang iyong account | I-enable ang read/view permission sa key |
| Spot/Futures Permission Disabled | Hindi makapaglagay ang key ng mga order na kailangan ng bot mo | I-enable ang trading type (Spot o Futures) na tumutugma sa bot mo |
| Connection Failed | Pansamantalang isyu sa network o exchange | Sandaling maghintay at subukang idagdag muli ang key |
Titiyakin din ng Freya ang isang key na nasa "Unrestricted" mode — ibig sabihin ay walang IP restriction ito. Para sa iyong seguridad, hinihiling ng Freya na i-on ang IP restriction at idagdag ang address na ipinapakita nito bago ma-save ang key. I-enable lamang ang reading at trading (hindi kailanman withdrawal), at limitahan ang key sa IP ng Freya. (Higit pa tungkol sa mga error sa koneksyon sa Hindi Makakonekta ang Iyong Exchange?.)
Isang Paalala Tungkol sa Seguridad
Ligtas ang koneksyon sa pagkakadisenyo nito, ngunit may ilang gawi na nagpapanatili nitong ganoon:
- Withdrawal off, palagi — hindi ito kailanman kailangan ng Freya.
- Gamitin ang IP whitelisting kapag sinusuportahan ito ng exchange mo.
- Isang key, isang layunin — at burahin ang mga key na hindi mo na ginagamit.
Para sa buong larawan kung paano protektado ang iyong pondo at mga key, tingnan ang Ligtas Ba ang Pera Ko sa Freya Finance? at Seguridad ng Exchange API at Pagbabawas ng Panganib.
Mga Madalas Itanong
Anong mga permission ang kailangan ng Freya sa aking API key?
Reading (para makita ang iyong mga balance, posisyon, at order) at Spot at/o Futures trading (para maglagay ng mga order ng bot mo). I-enable ang trading type na tumutugma sa mga bot na patatakbuhin mo. Hindi kailanman kailangan ng Freya ang withdrawal permission, kaya palaging iwanang naka-disable iyon.
Kailangan ba ng Freya ng permission para i-withdraw ang pondo ko?
Hindi. Naglalagay at namamahala lamang ang Freya ng mga trade; hindi nito magagawa at hindi dapat magagawang maglipat ng pondo palabas ng iyong exchange. Palaging iwanang naka-off ang withdrawal permission sa key na ikinokonekta mo — ito ay isang permission na ikaw ang may kontrol sa exchange.
Bakit sinasabi ng Freya na "IP Address Not Whitelisted"?
Naka-restrict ang API key mo sa mga tiyak na IP address, at wala sa listahan ang address ng Freya. Idagdag ang mga IP address ng Freya sa whitelist ng key sa iyong exchange, o alisin ang IP restriction mula sa key. Pagkatapos i-update ito, idagdag muli ang key sa Freya.
Bakit sinasabi nitong "Invalid API Key" o "Invalid Secret Key"?
Kadalasan, mali ang pagkakakopya ng key o secret, o binura o ginawang muli ang key sa exchange. Kopyahin muli ang parehong halaga nang eksakto. Dahil isang beses lang ipinapakita ang secret kapag ginawa mo ang key, kung wala ka na nito, burahin ang key sa exchange at gumawa ng bago.
Ano ang passphrase, at bakit ito hinihingi ng OKX?
Ang mga OKX API key ay may kasamang passphrase na ikaw mismo ang nagtatakda kapag ginagawa mo ang key — ito ay dagdag na credential kasama ng key at secret. Ilagay ang parehong passphrase sa Freya kapag nagdadagdag ng OKX key. Hindi gumagamit ng passphrase ang Binance at Bybit.
Maaari ba akong magkonekta ng higit sa isang exchange?
Oo. Maaari kang magdagdag ng mga API key para sa Binance, OKX, at Bybit, at i-manage o burahin ang mga ito anumang oras mula sa Mga Setting → API Keys.
Ligtas bang ibigay ang aking API key sa Freya?
Oo, kapag tama ang pagkakaayos ng key — reading at trading lamang, walang withdrawal, at naka-IP-whitelist kung maaari. Nananatili ang pondo mo sa sarili mong exchange, at hindi ito mailipat ng key na ibinabahagi mo. Para sa buong paliwanag, tingnan ang Ligtas Ba ang Pera Ko sa Freya Finance?.
Anong mga exchange ang sinusuportahan ng Freya?
Sa kasalukuyan, kumokonekta ang Freya sa Binance, OKX, at Bybit (spot at futures). Maaaring may maidagdag pang mga exchange sa paglipas ng panahon. Nagta-trade ka sa alinman sa mga ito na ikonekta mo — ang pondo mo at ang mga available na market ay nananatili sa exchange na iyon.
Anong mga coin o trading pair ang maaari kong i-trade?
Ang mga available na pair ay nagmumula sa sariling listing ng exchange na ikinonekta mo, hindi mula sa hiwalay na listahan ng Freya — kaya kung nakalista sa exchange mo ang isang pair (hal. BTC/USDT, ETH/USDT), maaari kang bumuo ng bot dito. Karamihan ng trading ay laban sa USDT bilang quote currency. Kung ma-delist ng exchange ang isang pair, hihinto itong ma-trade doon.