Usa la Stock Events API

L'API di Stock Events è una funzione Pro per automatizzare i dati nel tuo account Stock Events partendo dai tuoi strumenti personali. È progettata per l'automazione dell'account, non come un'API generica per i dati di mercato o la ricerca di simboli.

Le richieste di scrittura modificano le stesse watchlist, i simboli e le transazioni che vedi in Stock Events.

Cosa puoi fare con l'API

• Elencare, creare, recuperare e aggiornare le watchlist.
• Elencare, aggiungere, aggiornare e rimuovere simboli da una watchlist.
• Elencare, creare, recuperare, aggiornare e cancellare le transazioni.
• Leggere le viste calcolate di Holdings e Dividendi.

Come creare una chiave API

Per creare e utilizzare le chiavi API è necessaria un'attivazione Pro di Stock Events.

1. Accedi alla web app di Stock Events.
2. Apri il tuo Profilo.
3. Seleziona Impostazioni.
4. Sotto Account, seleziona Dati.
5. Seleziona Chiavi API.
6. Seleziona Crea chiave API.
7. Inserisci un Nome descrittivo, quindi seleziona Crea.
8. Seleziona Copia chiave API e conserva la chiave in modo sicuro prima di chiudere la finestra di dialogo.

La chiave API completa viene mostrata una sola volta. Dopo aver chiuso la finestra di dialogo, la schermata delle Chiavi API mostrerà il nome, il prefisso, la data di creazione e l'ultima data di utilizzo invece della chiave completa.

Se il tuo abbonamento Pro diventa inattivo, le tue chiavi rimarranno collegate al tuo account, ma le richieste API restituiranno 403 Forbidden finché l'accesso Pro non tornerà attivo.

Fai la tua prima richiesta

L'URL base dell'API è https://stockevents.app/api/v1. Invia la tua chiave API come bearer token nell'header Authorization.

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

Questa richiesta restituisce le tue watchlist e i loro ID. Puoi usare l'ID di una watchlist con gli endpoint specifici per simboli, Holdings e Dividendi della watchlist stessa.

Per i campi delle richieste, le strutture di risposta, i parametri opzionali e tutti gli endpoint disponibili, consulta queste risorse:

• Documentazione API di Stock Events
• Impostazioni Chiavi API
• Documento OpenAPI

Mantieni la tua chiave API al sicuro

Tratta una chiave API come se fosse una password. Non caricarla nel controllo versione (source control), non esporla nel codice client pubblico e non inviarla come parametro di query o nel corpo della richiesta.

Le chiavi API autenticano l'API di automazione dell'account senza permessi separati per ogni chiave. Usale solo con strumenti di cui ti fidi.

Se una chiave viene esposta, torna su Chiavi API, seleziona Revoca chiave API e poi conferma Revoca. La chiave smetterà di funzionare immediatamente e non potrà essere riattivata. Crea una nuova chiave se necessario.

Errori comuni

• 401 Unauthorized: La chiave API manca, è non valida o è stata revocata.
• 403 Forbidden: L'account al momento non ha un accesso Pro attivo.