När du lägger till en API-nyckel för din börs kontrollerar Freya den innan den sparas — och om något är fel talar den om vad du behöver rätta till. Den här guiden hjälper dig att läsa det resultatet och åtgärda det. (Om din nyckel redan anslöt utan problem men en bot senare stannade är det ett annat problem — se Varför pausades eller stoppades min bot?.)
För stegen vid den första inställningen, börja med Så ansluter du din börs; den här artikeln handlar om vad du gör när den anslutningen misslyckas.
Viktigast
- När du lägger till en nyckel kontrollerar Freya innan den sparas att den ansluter och har rätt behörigheter — om något misslyckas talar felet om vad du behöver rätta till.
- "Ogiltig API-nyckel/Secret" betyder oftast ett kopiera/klistra-in-misstag eller en nyckel som genererats om; "IP"-fel betyder att nyckelns IP-begränsning inte matchar det Freya behöver.
- Din nyckel måste ha läs- och handelsbehörigheter (aldrig uttag) och vara aktiverad för rätt marknad — Spot eller Futures — så att den matchar din bot.
- OKX-nycklar kräver en lösenfras som måste stämma exakt; för Futures-nycklar förbereder Freya automatiskt ditt konto så att boten kan handla korrekt.
- Ett allmänt "Anslutning misslyckades" beror ofta på en tillfällig hicka i nätverket eller hos börsen — försök bara igen.
När en nyckel inte vill ansluta
Att lägga till en nyckel är ingen blind sparning — Freya verifierar att nyckeln fungerar och har rätt behörigheter innan den lagras krypterat. Om något är fel pekar felet dig direkt mot orsaken — oftast nyckeln eller secret, IP-begränsningen eller en saknad behörighet. Avsnitten nedan går igenom varje fel och hur du åtgärdar det.
"Ogiltig API-nyckel" eller "Ogiltig Secret"
Det vanligaste anslutningsfelet, och oftast det enklaste:
- Ett kopiera/klistra-in-misstag — ett vilset mellanslag eller ett saknat tecken. Kopiera både nyckeln och secret noggrant på nytt.
- Secret visas bara en gång. Börser visar secret ett enda tillfälle när du skapar den. Om du inte sparade den kan du inte återställa den — skapa en ny nyckel.
- Nyckeln raderades eller genererades om på börsen, så att den inte längre stämmer.
Lösning: ange nyckeln och secret exakt på nytt, eller skapa en helt ny nyckel och försök igen.
IP-begränsningsfel
Freya ansluter från sina egna servrar, så nyckelns IP-inställningar spelar roll. Det finns två skilda fall:
- "IP inte vitlistad" — din nyckel är IP-begränsad, men Freyas serveradress finns inte på dess tillåtelselista. Skärmen för att lägga till API-nyckel visar dig IP-adressen/adresserna du ska lägga till (med en kopieringsknapp) — lägg till dem i nyckelns vitlista på börsen.
- "Obegränsad" — din nyckel har ingen IP-begränsning alls. För din säkerhet ber Freya dig att aktivera IP-begränsning och lägga till adressen den visar, och sedan försöka igen.
I båda fallen är lösningen samma tanke: begränsa nyckeln till den IP som Freya visar i dialogrutan.
Behörighetsfel
Nyckeln anslöt, men den kan inte göra det din bot behöver:
- Läsning inaktiverad — aktivera läs-/visningsbehörigheten på nyckeln.
- Handelsbehörighet saknas — aktivera handel (Spot och/eller Futures, matchande din bot).
- Spot och Futures matchar inte — en Futures-bot behöver en nyckel med Futures-handel aktiverad; en Spot-bot behöver Spot-handel. Om du lade till en nyckel med enbart Spot för en Futures-bot (eller tvärtom) flaggar Freya det. Se till att nyckelns aktiverade marknad matchar boten du bygger.
Kom ihåg: Freya behöver alltid bara läs- och handelsbehörigheter — aldrig uttag. En nyckel utan uttagsbehörighet är precis vad du vill ha.
Börsspecifika fallgropar
- OKX behöver en lösenfras. När du skapar en OKX-nyckel ställer du in en lösenfras — ange exakt samma lösenfras i Freya, precis som du ställde in den. En felaktig lösenfras är ett vanligt OKX-anslutningsfel.
- OKX Futures-inställning. OKX Futures-handel behöver ett specifikt kontoläge, som Freya ställer in åt dig automatiskt — du behöver inte konfigurera det manuellt.
- Hedge-läge (Futures). Freya använder hedge-läge för Futures-konton. Om du redan har öppna enkelriktade positioner som står i konflikt kan du få se en varning i stället för ett fel — nyckeln sparas ändå, och din bot kan handla när de befintliga positionerna har stängts.
- Binance och Bybit använder ingen lösenfras — det finns inget lösenfrasfält för dem.
"Anslutning misslyckades" utan tydlig orsak
Ett allmänt anslutningsfel beror ofta inte på dig — en tillfällig störning i nätverket eller att börsen är kortvarigt upptagen. Vänta en stund och försök igen. Om det fortsätter att misslyckas efter några försök, kontrollera nyckel/secret och IP-inställningarna ovan igen.
Fortfarande fast? En snabb checklista
- Skapa nyckeln på nytt på börsen med endast läs + handel (aldrig uttag).
- Begränsa den till den IP som Freya visar på skärmen för att lägga till API-nyckel.
- Matcha marknaden — Spot-nyckel för en Spot-bot, Futures-nyckel för en Futures-bot.
- OKX: ange den exakta lösenfrasen.
- Misslyckas det fortfarande? Kontakta [email protected].
Vanliga frågor
Freya säger "Ogiltig API-nyckel" men jag är säker på att jag kopierade den korrekt — vad är fel?
Oftast har ett dolt tecken eller mellanslag smugit sig in i nyckeln eller secret, eller så genererades nyckeln om/raderades på börsen så att den inte längre stämmer. Kopiera båda fälten noggrant på nytt, och kom ihåg att secret bara visas en gång vid skapandet — om du inte har den, skapa en ny nyckel.
Vad är skillnaden mellan "IP inte vitlistad" och "Obegränsad"?
"IP inte vitlistad" betyder att din nyckel är IP-begränsad men att Freyas serveradress ännu inte är tillåten — lägg till adressen Freya visar i nyckelns vitlista. "Obegränsad" betyder att nyckeln inte har någon IP-begränsning alls; av säkerhetsskäl ber Freya dig att aktivera IP-begränsning och lägga till dess adress innan du sparar.
Min OKX-nyckel vill inte ansluta — behöver jag lösenfrasen?
Ja. OKX-nycklar har en lösenfras som du ställer in när du skapar nyckeln. Du måste ange exakt den lösenfrasen i Freya — en felaktig eller saknad lösenfras är ett vanligt OKX-anslutningsfel. Binance och Bybit använder ingen.
Freya säger att min nyckel inte kan lägga ordrar — hur åtgärdar jag det?
Din nyckel har inte handel aktiverad för marknaden som din bot använder. På börsen, aktivera handelsbehörigheten — Spot-handel för en Spot-bot, Futures-handel för en Futures-bot — och anslut sedan på nytt. Freya behöver läs- och handelsbehörigheter, aldrig uttag.
Min Futures-nyckel behöver extra inställning (kontoläge / hedge-läge) — är det ett problem?
Nej. Futures-handel behöver ett specifikt kontoläge och hedge-läge, som Freya ställer in åt dig automatiskt. Om du har befintliga enkelriktade positioner kan du få se en hedge-läge-varning i stället för ett fel — nyckeln sparas ändå, och din bot kan handla när de positionerna har stängts.
Jag lade till en Spot-nyckel men min Futures-bot vill inte använda den (eller tvärtom) — varför?
En nyckel är aktiverad för en specifik marknad. En Futures-bot behöver en nyckel med Futures-handel aktiverad, och en Spot-bot behöver Spot-handel. Om de inte matchar flaggar Freya det. Anslut en nyckel vars aktiverade marknad matchar boten du skapar.
Anslutningen "misslyckades" bara utan tydlig orsak — är det jag eller börsen?
Ofta är det en tillfällig hicka i nätverket eller hos börsen snarare än dina inställningar. Försök igen om en stund. Om det fortsätter att misslyckas, kontrollera nyckeln och secret för kopieringsfel och bekräfta att IP-begränsningen matchar adressen Freya visar.