Stock Events

Stock Events

Usa la API de Stock Events

La API de Stock Events es una función Pro para automatizar los datos de tu cuenta de Stock Events desde tus propias herramientas. Está diseñada para la automatización de cuentas, no como una API general de datos de mercado o búsqueda de símbolos.

Las solicitudes de escritura modifican las mismas watchlists, símbolos y transacciones que ves en Stock Events.

Qué puedes hacer con la API

Listar, crear, recuperar y actualizar watchlists.
  • Listar, añadir, actualizar y eliminar símbolos en una watchlist.
  • Listar, crear, recuperar, actualizar y eliminar transacciones.
  • Leer las vistas calculadas de Holdings y Dividends.

    • Cómo crear una API key

    Necesitas una suscripción activa a Stock Events Pro para crear y usar API keys.

    1. Inicia sesión en la web app de Stock Events.
    2. Abre tu Profile.
    3. Selecciona Settings.
    4. En Account, selecciona Data.
    5. Selecciona API Keys.
    6. Selecciona Create API key.
    7. Introduce un Name descriptivo y luego selecciona Create.
    8. Selecciona Copy API key y guarda la clave de forma segura antes de cerrar el diálogo.

    La API key completa solo se muestra una vez. Después de cerrar el diálogo, la pantalla de API Keys mostrará su nombre, prefijo, fecha de creación y fecha de último uso en lugar de la clave completa.

    Si tu suscripción Pro deja de estar activa, tus claves seguirán vinculadas a tu cuenta, pero las solicitudes de la API devolverán 403 Forbidden hasta que el acceso Pro esté activo de nuevo.

    Haz tu primera solicitud

    La URL base de la API es https://stockevents.app/api/v1. Envía tu API key como un bearer token en el header de Authorization.

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

    Esta solicitud devuelve tus watchlists y sus IDs. Puedes usar el ID de una watchlist con los endpoints de símbolos, Holdings y Dividends específicos de esa watchlist.

    Para consultar los campos de las solicitudes, las estructuras de respuesta, los parámetros opcionales y todos los endpoints disponibles, usa estos recursos:

    Mantén tu API key segura

    Trata una API key como si fuera una contraseña. No la subas a un control de versiones, no la expongas en código cliente público ni la envíes en un parámetro de consulta o en el cuerpo de una solicitud.

    Las API keys autentican la API de automatización de cuentas sin necesidad de permisos separados para cada clave. Úsalas solo con herramientas en las que confíes.

    Si una clave queda expuesta, vuelve a API Keys, selecciona Revoke API key y luego confirma Revoke. La clave dejará de funcionar inmediatamente y no podrá reactivarse. Crea una nueva clave si lo necesitas.

    Errores comunes

    • 401 Unauthorized: La API key falta, no es válida o ha sido revocada.
    • 403 Forbidden: La cuenta no tiene acceso Pro activo en este momento.