Pag-aayos ng mga error sa koneksyon ng exchange API key

Kapag nagdagdag ka ng exchange API key, tsinetsek ito ng Freya bago i-save — at kung may mali, sasabihin nito sa iyo kung ano ang aayusin. Tinutulungan ka ng gabay na ito na basahin ang resultang iyon at ayusin ito. (Kung nakakonekta na nang maayos ang iyong key pero nag-stop ang isang bot mamaya, ibang problema na iyon — tingnan ang Bakit Nag-pause o Nag-stop ang Aking Bot?.)

Para sa mga hakbang sa first-time setup, magsimula sa Paano I-connect ang Iyong Exchange; ang artikulong ito ay tungkol sa kung ano ang gagawin kapag nabigo ang koneksyong iyon.

Kapag Ayaw Kumonekta ng Isang Key

Ang pagdagdag ng key ay hindi bulag na pag-save — kinukumpirma ng Freya na gumagana ang key at may tamang mga permission bago ito i-store nang naka-encrypt. Kung may mali, direktang itinuturo sa iyo ng error ang sanhi — kadalasan ang key o secret, ang IP restriction, o isang nawawalang permission. Tinatalakay ng mga seksyon sa ibaba ang bawat error at kung paano ito ayusin.

"Invalid API Key" o "Invalid Secret Key"

Ang pinakakaraniwang error sa koneksyon, at kadalasan ang pinakasimple:

• Maling copy/paste — isang nalihis na space o nawawalang character. I-copy ulit nang maingat ang key at ang secret.
• Isang beses lang ipinapakita ang secret. Ipinapakita ng mga exchange ang secret key nang isang beses lang kapag ginawa mo ito. Kung hindi mo ito na-save, hindi mo na ito mababawi — gumawa ng bagong key.
• Na-delete o na-regenerate ang key sa exchange, kaya hindi na ito tumutugma.

Fix: ilagay ulit ang key at secret nang eksakto, o gumawa ng bagong key at subukan ulit.

Mga Error sa IP Restriction

Kumokonekta ang Freya mula sa sarili nitong mga server, kaya mahalaga ang IP settings ng key. May dalawang magkaibang kaso:

• "IP Not Whitelisted" — naka-IP-restrict ang iyong key, pero wala sa allow-list nito ang server address ng Freya. Ipinapakita sa iyo ng Add API Key screen ang IP address(es) na idadagdag (may copy button) — idagdag ang mga ito sa whitelist ng key sa exchange.
• "Unrestricted" — wala kang IP restriction man lang sa key. Para sa iyong kaligtasan, hinihiling ng Freya na i-on ang IP restriction at idagdag ang address na ipinapakita nito, tapos subukan ulit.

Sa parehong kaso, iisa ang ideya ng fix: i-restrict ang key sa IP na ipinapakita ng Freya sa modal.

Mga Error sa Permission

Nakakonekta ang key, pero hindi nito magawa ang kailangan ng iyong bot:

• Naka-disable ang pagbabasa — i-enable ang read/view permission sa key.
• Nawawala ang trade permission — i-enable ang trading (spot at/o futures, ayon sa iyong bot).
• Hindi tugma ang Spot vs Futures — kailangan ng isang futures bot ng key na may naka-enable na futures trading; kailangan ng isang spot bot ng spot trading. Kung nagdagdag ka ng spot-only na key para sa isang futures bot (o kabaligtaran), imamarkahan ito ng Freya. Siguraduhing tumutugma ang naka-enable na market ng key sa bot na ginagawa mo.

Tandaan: read at trade permissions lang ang kailangan ng Freya — huwag kailanman withdrawal. Ang key na walang withdrawal permission ang eksaktong gusto mo.

Mga Espesipikong Detalye sa Bawat Exchange

• Kailangan ng OKX ng passphrase. Kapag gumawa ka ng OKX key, may itinatakda kang passphrase — ilagay ang parehong passphrase sa Freya, eksakto tulad ng itinakda mo. Ang maling passphrase ay karaniwang sanhi ng nabigong koneksyon sa OKX.
• Setup ng OKX futures. Kailangan ng OKX futures trading ng isang partikular na account mode, na awtomatikong inihahanda ng Freya para sa iyo — hindi mo na kailangang i-configure ito nang manu-mano.
• Hedge mode (futures). Ginagamit ng Freya ang hedge mode para sa mga futures account. Kung may nakabukas ka nang one-way positions na nagkakasalungatan, maaari kang makakita ng babala sa halip na pagkabigo — nase-save pa rin ang key, at makakapag-trade ang iyong bot kapag naisara na ang mga umiiral na position na iyon.
• Ang Binance at Bybit ay hindi gumagamit ng passphrase — walang passphrase field para sa kanila.

"Connection Failed" Nang Walang Malinaw na Dahilan

Ang pangkalahatang pagkabigo ng koneksyon ay kadalasang hindi mo kasalanan — panandaliang network blip o sandaling abala ang exchange. Maghintay sandali at subukan ulit. Kung patuloy na nabibigo pagkatapos ng ilang subok, i-check ulit ang key/secret at IP settings sa itaas.

Naiipit Pa Rin? Isang Mabilis na Checklist

1. Gawing muli ang key sa exchange na may read + trade lang (huwag kailanman withdrawal).
2. I-restrict ito sa IP na ipinapakita ng Freya sa Add API Key screen.
3. Itugma ang market — spot key para sa spot bot, futures key para sa futures bot.
4. OKX: ilagay ang eksaktong passphrase.
5. Nabibigo pa rin? Makipag-ugnayan sa [email protected].

Mga Madalas Itanong

Sinasabi ng Freya na "Invalid API Key" pero sigurado akong tama ang pagkakacopy ko — ano ang mali?

Kadalasan ay may nakatagong character o space na nakapasok sa key o secret, o na-regenerate/na-delete ang key sa exchange kaya hindi na tumutugma. I-copy ulit ang parehong field nang maingat, at tandaan na isang beses lang ipinapakita ang secret sa paggawa — kung wala ka nito, gumawa ng bagong key.

Ano ang pagkakaiba ng "IP Not Whitelisted" at "Unrestricted"?

Ang "IP Not Whitelisted" ay nangangahulugang naka-IP-restrict ang iyong key pero hindi pa pinapayagan ang server address ng Freya — idagdag ang address na ipinapakita ng Freya sa whitelist ng key. Ang "Unrestricted" ay nangangahulugang walang IP restriction man lang ang key; para sa kaligtasan, hinihiling ng Freya na i-on ang IP restriction at idagdag ang address nito bago i-save.

Ayaw kumonekta ng aking OKX key — kailangan ko ba ng passphrase?

Oo. May passphrase ang mga OKX key na itinatakda mo kapag gumagawa ng key. Dapat mong ilagay ang eksaktong passphrase na iyon sa Freya — ang maling o nawawalang passphrase ay karaniwang sanhi ng nabigong koneksyon sa OKX. Hindi ito ginagamit ng Binance at Bybit.

Sinasabi ng Freya na hindi makapaglagay ng trade ang aking key — paano ko ito aayusin?

Walang naka-enable na trading ang iyong key para sa market na ginagamit ng iyong bot. Sa exchange, i-enable ang trade permission — spot trading para sa spot bot, futures trading para sa futures bot — tapos ikonekta ulit. Kailangan ng Freya ng read at trade permissions, hindi kailanman withdrawal.

Kailangan ng aking futures key ng dagdag na setup (account mode / hedge mode) — problema ba iyon?

Hindi. Kailangan ng futures trading ng isang partikular na account mode at hedge mode, na awtomatikong inihahanda ng Freya para sa iyo. Kung may umiiral kang one-way positions, maaari kang makakita ng hedge-mode warning sa halip na error — nase-save pa rin ang key, at makakapag-trade ang iyong bot kapag naisara na ang mga position na iyon.

Nagdagdag ako ng spot key pero ayaw itong gamitin ng aking futures bot (o kabaligtaran) — bakit?

Ang isang key ay naka-enable para sa isang partikular na market. Kailangan ng futures bot ng key na may naka-enable na futures trading, at kailangan ng spot bot ng spot trading. Kung hindi tumutugma, imamarkahan ito ng Freya. Ikonekta ang key na ang naka-enable na market ay tumutugma sa bot na ginagawa mo.

Basta "nabigo" lang ang koneksyon nang walang malinaw na dahilan — ako ba o ang exchange?

Kadalasan ay panandaliang network o exchange hiccup ito, hindi ang iyong settings. Subukan ulit maya-maya. Kung patuloy na nabibigo, i-check ulit ang key at secret para sa mga copy error at kumpirmahin na tumutugma ang IP restriction sa address na ipinapakita ng Freya.