Innan en bot kan handla åt dig behöver Freya en anslutning till börsen där dina medel finns — Binance, OKX eller Bybit. Du flyttar varken dina medel eller delar ditt lösenord för att göra detta. I stället skapar du en API-nyckel: en begränsad behörighet som låter Freya lägga order åt dig, samtidigt som dina pengar stannar på ditt eget börskonto.
Den här guiden förklarar exakt vilka behörigheter du ska ge (och vilka du aldrig ska ge), hur du lägger till nyckeln i Freya och vad du gör om anslutningen inte valideras. Om du vill ha den större bilden av varför detta är säkert, läs Är mina pengar säkra på Freya Finance? först.
Viktigast
- Du ansluter en börs med en API-nyckel — en begränsad behörighet — inte genom att flytta medel eller dela ditt börslösenord.
- Nyckeln behöver behörigheter för Läsning samt Spot- och/eller Futures-handel. Den får ALDRIG ha uttagsbehörighet.
- OKX-nycklar kräver en lösenfras som du anger när du skapar dem; Binance och Bybit gör det inte.
- Lägg till nyckeln i Freya under Inställningar → API-nycklar → Lägg till API-nyckel, så validerar Freya den direkt.
- Om valideringen misslyckas talar Freya om exakt varför — ogiltig nyckel, IP inte på vitlistan eller en saknad behörighet — och var och en har en enkel lösning.
En snabb översikt över stegen
- Skapa en API-nyckel på din börs med läs- och handelsbehörigheter, men inte uttag.
- Kopiera uppgifterna — API-nyckeln, den hemliga nyckeln och (för OKX) lösenfrasen.
- Lägg till nyckeln i Freya under Inställningar → API-nycklar → Lägg till API-nyckel, och välj din börs.
- Låt Freya validera den — Freya kontrollerar anslutningen och behörigheterna omedelbart.
- Åtgärda eventuella fel den rapporterar — Freya talar om exakt vad som är fel om valideringen misslyckas.
Vad en API-nyckel är — och vilka behörigheter Freya behöver
En API-nyckel är ett par uppgifter (en nyckel och en hemlig nyckel) som låter en app kommunicera med ditt börskonto på ett begränsat sätt. Du bestämmer vad den nyckeln får göra. Aktivera endast följande för Freya:
- Läsning — så att Freya kan se dina saldon, positioner och orderstatus.
- Spot-handel och/eller Futures-handel — så att din bot kan lägga de order den behöver. Aktivera det som matchar de bottar du planerar att köra.
Freya lägger order; den behöver aldrig flytta pengar ut från ditt konto. Lämna alltid uttagsbehörigheten avstängd på nyckeln du ansluter. Detta är en behörighet du styr på börsen — med den avstängd kan varken Freya eller någon som skulle kunna komma över nyckeln ta ut dina medel. Det är den viktigaste vanan när du ansluter någon som helst botplattform.
Steg 1: Skapa en API-nyckel på din börs
I avsnittet API-hantering på din börs skapar du en ny API-nyckel:
- Binance — skapa nyckeln under API Management, aktivera läsning och Spot- och/eller Futures-handel, och lämna uttag avstängt.
- OKX — skapa nyckeln och ange en lösenfras (du behöver den i Freya); aktivera läsning och handel, inte uttag.
- Bybit — skapa nyckeln med läs- och handelsbehörigheter för de produkter du ska använda, och lämna uttag avstängt.
Om din börs erbjuder IP-vitlistning är det god praxis att begränsa nyckeln till Freyas IP-adresser. Om du gör det, se till att vitlista Freyas IP-adresser, annars nekas anslutningen (se feltabellen längre ned).
När du skapar nyckeln visar börsen den hemliga nyckeln en enda gång. Kopiera den direkt och förvara den säkert. Om du tappar bort den kan du inte återställa den — du måste radera nyckeln och skapa en ny.
Steg 2: Lägg till nyckeln i Freya
I Freya går du till Inställningar → API-nycklar och väljer Lägg till API-nyckel. Sedan:
- Välj din börs (Binance, OKX eller Bybit).
- Klistra in API-nyckeln och den hemliga nyckeln. För OKX anger du även lösenfrasen du satte.
- Ge nyckeln ett namn så att du känner igen den senare.
Du kan ansluta fler än en börs och hantera eller radera dina nycklar från samma sida när som helst.
Steg 3: Freya validerar din nyckel
Så snart du lägger till nyckeln kontrollerar Freya anslutningen och behörigheterna — inga gissningar. Om allt är korrekt verifieras nyckeln och är redo att användas. Om något är fel visar Freya ett tydligt meddelande som förklarar exakt vad som ska åtgärdas.
Förstå valideringsfel
Om valideringen misslyckas, matcha meddelandet Freya visar mot lösningen nedan:
| Vad Freya visar | Vad det betyder | Så åtgärdar du det |
|---|---|---|
| Ogiltig API-nyckel | Nyckeln kopierades fel eller raderades på börsen | Kopiera API-nyckeln exakt igen, eller skapa en ny |
| Ogiltig hemlig nyckel | Den hemliga nyckeln matchar inte nyckeln | Kopiera den hemliga nyckeln igen; om du tappat bort den, skapa en ny nyckel |
| IP-adress inte på vitlistan | Nyckeln är IP-begränsad och Freyas adress tillåts inte | Vitlista Freyas IP-adresser på nyckeln, eller ta bort IP-begränsningen |
| Saknade behörigheter | Nyckeln saknar läs- eller handelsbehörighet | Aktivera läsning och Spot-/Futures-handel på nyckeln |
| Läsbehörighet avstängd | Freya kan inte läsa ditt konto | Aktivera läs-/visningsbehörigheten på nyckeln |
| Spot-/Futures-behörighet avstängd | Nyckeln kan inte lägga de order din bot behöver | Aktivera den handelstyp (Spot eller Futures) som matchar din bot |
| Anslutning misslyckades | Ett tillfälligt nätverks- eller börsproblem | Vänta en stund och försök lägga till nyckeln igen |
Freya markerar även en nyckel som är i ”Unrestricted”-läge — det vill säga som saknar IP-begränsning. För din säkerhet ber Freya dig att slå på IP-begränsning och lägga till adressen den visar innan nyckeln kan sparas. Aktivera endast läsning och handel (aldrig uttag) och begränsa nyckeln till Freyas IP. (Mer om anslutningsfel i Kan du inte ansluta din börs?.)
En notis om säkerhet
Anslutningen är säker i sin utformning, men några få vanor håller den så:
- Uttag alltid avstängt — Freya behöver det aldrig.
- Använd IP-vitlistning när din börs stöder det.
- En nyckel, ett syfte — och radera nycklar du inte längre använder.
För hela bilden av hur dina medel och nycklar skyddas, se Är mina pengar säkra på Freya Finance? och Börs-API-säkerhet och riskminskning.
Vanliga frågor
Vilka behörigheter behöver Freya på min API-nyckel?
Läsning (för att se dina saldon, positioner och order) samt Spot- och/eller Futures-handel (för att lägga din bots order). Aktivera den handelstyp som matchar de bottar du ska köra. Freya behöver aldrig uttagsbehörighet, så lämna alltid den avstängd.
Behöver Freya behörighet att ta ut mina medel?
Nej. Freya lägger och hanterar endast order; den kan och ska inte kunna flytta medel ut från din börs. Lämna alltid uttagsbehörigheten avstängd på nyckeln du ansluter — det är en behörighet du styr på börsen.
Varför säger Freya ”IP-adress inte på vitlistan”?
Din API-nyckel är begränsad till specifika IP-adresser, och Freyas adress finns inte på listan. Lägg antingen till Freyas IP-adresser i nyckelns vitlista på din börs, eller ta bort IP-begränsningen från nyckeln. Efter att du uppdaterat den lägger du till nyckeln i Freya igen.
Varför står det ”Ogiltig API-nyckel” eller ”Ogiltig hemlig nyckel”?
Oftast kopierades nyckeln eller den hemliga nyckeln fel, eller så raderades eller regenererades nyckeln på börsen. Kopiera båda värdena exakt igen. Eftersom den hemliga nyckeln bara visas en gång när du skapar nyckeln behöver du, om du inte längre har den, radera nyckeln på börsen och skapa en ny.
Vad är lösenfrasen, och varför frågar OKX efter den?
OKX-API-nycklar innehåller en lösenfras som du själv anger när du skapar nyckeln — den är en extra behörighet vid sidan av nyckeln och den hemliga nyckeln. Ange samma lösenfras i Freya när du lägger till en OKX-nyckel. Binance och Bybit använder ingen lösenfras.
Kan jag ansluta fler än en börs?
Ja. Du kan lägga till API-nycklar för Binance, OKX och Bybit och hantera eller radera dem när som helst under Inställningar → API-nycklar.
Är det säkert att ge Freya min API-nyckel?
Ja, när nyckeln är korrekt inställd — endast läsning och handel, inget uttag och IP-vitlistad där det är möjligt. Dina medel stannar på din egen börs, och nyckeln du delar kan inte flytta dem. För den fullständiga förklaringen, se Är mina pengar säkra på Freya Finance?.
Vilka börser stöder Freya?
Freya ansluter för närvarande till Binance, OKX och Bybit (spot och futures). Fler börser kan komma att läggas till med tiden. Du handlar på den du ansluter — dina medel och de tillgängliga marknaderna stannar på den börsen.
Vilka mynt eller handelspar kan jag handla?
De tillgängliga paren kommer från din anslutna börs egna listningar, inte från en separat Freya-lista — så om din börs listar ett par (t.ex. BTC/USDT, ETH/USDT) kan du bygga en bot på det. Det mesta av handeln sker mot USDT som quote-valuta. Om en börs avlistar ett par går det inte längre att handla där.