Stock Events

Stock Events

Použi Stock Events API

Stock Events API je Pro funkcia, ktorá ti umožní automatizovať dáta vo tvojom účte Stock Events priamo z tvojich vlastných nástrojov. Je navrhnutá na automatizáciu účtu, nie ako všeobecné API pre trhové dáta alebo vyhľadávanie symbolov.

Write requests upravujú rovnaké watchlisty, symboly a transakcie, ktoré vidíš v Stock Events.

Čo všetko s API môžeš robiť

Zoznam, vytváranie, získavanie a aktualizácia watchlistov.
  • Zoznam, pridávanie, aktualizácia a odstraňovanie symbolov v watchliste.
  • Zoznam, vytváranie, získavanie, aktualizácia a mazanie transakcií.
  • Čítanie vypočítaných pohľadov Holdings a Dividends.

    • Ako si vytvoriť API key

    Na vytváranie a používanie API keys potrebuješ aktívne predplatné Stock Events Pro.

    1. Prihlás sa do webovej aplikácie Stock Events.
    2. Otvor svoj Profile.
    3. Vyber si Settings.
    4. V sekcii Account vyber Data.
    5. Vyber API Keys.
    6. Klikni na Create API key.
    7. Zadaj popisný Name a potom vyber Create.
    8. Klikni na Copy API key a kľúč si bezpečne ulož, kým nezavretieš dialógové okno.

    Celý API key sa zobrazí len raz. Po zatvorení okna bude obrazovka API Keys zobrazovať len jeho názov, prefix, dátum vytvorenia a dátum posledného použitia namiesto celého kľúča.

    Ak tvoje Pro predplatné prestane byť aktívne, tvoje kľúče zostanú pripojené k účtu, ale API požiadavky budú vracať chybu , kým nebudeš mať Pro prístup opätovne aktívny.

    Urob svoju prvú požiadavku

    Základná URL adresa API je . Svoj API key pošli ako bearer token v hlavičke .

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

    Táto požiadavka ti vráti tvoje watchlisty a ich ID. ID watchlistu môžeš použiť pri endpointoch pre symboly, Holdings a Dividends, ktoré sa vzťahujú konkrétne k danému watchlistu.

    Pre polia v požiadavkách, štruktúru odpovedí, voliteľné parametre a všetky dostupné endpointy využij tieto zdroje:

    Chráň svoj API key

    K API keyu sa chovaj ako k heslu. Neukladaj ho do zdrojového kódu (source control), neexponuj ho vo verejnom klientskom kóde a neposielaj ho ako query parameter alebo v telu požiadavky.

    API keys autentifikujú API pre automatizáciu účtu bez potreby samostatných opráv pre každý kľúč. Používaj ich len s nástrojmi, ktorým dôveruješ.

    Ak dôjde k úniku kľúča, vráť sa do API Keys, vyber Revoke API key a potom potvrď Revoke. Kľúč okamžite prestane fungovať a nebude sa dať znova aktivovať. Ak budeš potrebovať, vytvor si nový kľúč.

    Bežné chyby

    • 401 Unauthorized: API key chýba, je neplatný alebo bol zrušený.
    • 403 Forbidden: Účet momentálne nemá aktívny Pro prístup.