Använd Stock Events API:et

Stock Events API är en Pro-funktion för att automatisera data i ditt Stock Events-konto direkt från dina egna verktyg. Den är designad för kontoautomatisering, inte som ett generellt API för marknadsdata eller sökning efter symboler.

Skrivskyddade förfrågningar (Write requests) ändrar samma bevakningslistor, symboler och transaktioner som du ser i Stock Events.

Vad du kan göra med API:et

Lista, skapa, hämta och uppdatera bevakningslistor (watchlists).
  • Lista, lägga till, uppdatera och ta bort symboler i en bevakningslista.
  • Lista, skapa, hämta, uppdatera och radera transaktioner.
  • Läsa beräknade vyer för Holdings och Dividends.
  • Så här skapar du en API-nyckel

    Du behöver en aktiv Stock Events Pro-prenumeration för att kunna skapa och använda API-nycklar.

    1. Logga in i Stock Events webbapp.
    2. Öppna din Profile.
    3. Välj Settings.
    4. Under Account, välj Data.
    5. Välj API Keys.
    6. Välj Create API key.
    7. Ange ett beskrivande Name och välj sedan Create.
    8. Välj Copy API key och spara nyckeln på ett säkert ställe innan du stänger dialogrutan.

    Den kompletta API-nyckeln visas bara en gång. När du har stängt dialogrutan visar skärmen för API Keys endast dess namn, prefix, skapandedatum och datum för senaste användning istället för hela nyckeln.

    Om din Pro-prenumeration blir inaktiv finns dina nycklar kvar kopplade till ditt konto, men API-anrop kommer att returnera 403 Forbidden tills Pro-åtkomsten är aktiv igen.

    Gör ditt första anrop

    API:ets bas-URL är https://stockevents.app/api/v1. Skicka din API-nyckel som en bearer token i Authorization-headern.

    curl -H "Authorization: Bearer $STOCK_EVENTS_API_KEY" \ 
      https://stockevents.app/api/v1/watchlists

    Det här anropet returnerar dina bevakningslistor och deras ID:n. Du kan använda ett watchlist-ID med de specifika ändpunkterna för symboler, Holdings och Dividends.

    För fält i förfrågningar, responsstrukturer, valfria parametrar och alla tillgängliga ändpunkter, använd dessa resurser:

    Håll din API-nyckel säker

    Behandla en API-nyckel som ett lösenord. Checka inte in den i källkodshantering (source control), exponera den inte i offentlig klientkod och skicka den inte i en query-parameter eller i en request body.

    API-nycklar autentiserar kontoautomatiseringens API utan separata behörigheter för varje nyckel. Använd dem bara med verktyg som du litar på.

    Om en nyckel har läckt, gå tillbaka till API Keys, välj Revoke API key och bekräfta sedan Revoke. Nyckeln slutar fungera omedelbart och kan inte återaktiveras. Skapa en ny nyckel om det behövs.

    Vanliga fel

    • 401 Unauthorized: API-nyckeln saknas, är ogiltig eller har återkallats.
    • 403 Forbidden: Kontot har för tillfället ingen aktiv Pro-åtkomst.