Stock Events

Stock Events

Gunakan Stock Events API

Stock Events API adalah fitur Pro untuk mengotomatiskan data di akun Stock Events kamu menggunakan tools buatanmu sendiri. API ini dirancang untuk otomatisasi akun, bukan sebagai API data pasar umum atau pencarian simbol.

Request tulis (write requests) akan mengubah watchlist, simbol, dan transaksi yang sama dengan yang kamu lihat di Stock Events.

Apa yang bisa kamu lakukan dengan API ini

List, buat, ambil, dan update watchlist kamu.
  • List, tambah, update, dan hapus simbol dalam sebuah watchlist.
  • List, buat, ambil, update, dan hapus transaksi.
  • Baca tampilan Holdings dan Dividends yang sudah dihitung.

    • Cara membuat API key

    Kamu butuh langganan Stock Events Pro yang aktif untuk membuat dan menggunakan API key.

    1. Login ke web app Stock Events.
    2. Buka Profile kamu.
    3. Pilih Settings.
    4. Di bawah bagian , pilih Data.
    5. Pilih API Keys.
    6. Pilih Create API key.
    7. Masukkan Name yang deskriptif, lalu pilih Create.
    8. Pilih Copy API key dan simpan key tersebut dengan aman sebelum menutup dialog.

    API key lengkap hanya akan ditampilkan satu kali. Setelah kamu menutup dialog, layar API Keys hanya akan menampilkan nama, prefix, tanggal pembuatan, dan tanggal terakhir digunakan, bukan key lengkapnya.

    Jika langganan Pro kamu tidak aktif, key kamu tetap terhubung ke akunmu, tapi request API akan mengembalikan 403 Forbidden sampai akses Pro kamu aktif kembali.

    Lakukan request pertama kamu

    Base URL API adalah https://stockevents.app/api/v1. Kirim API key kamu sebagai bearer token di header Authorization.

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

    Request ini akan mengembalikan daftar watchlist kamu beserta ID-nya. Kamu bisa menggunakan ID watchlist tersebut pada endpoint simbol, Holdings, dan Dividends yang spesifik untuk watchlist tersebut.

    Untuk detail field request, struktur response, parameter opsional, dan semua endpoint yang tersedia, silakan gunakan resource berikut:

    Jaga keamanan API key kamu

    Anggap API key seperti password. Jangan masukkan ke dalam source control, jangan ekspos di kode client publik, atau kirim melalui query parameter maupun request body.

    API keys mengautentikasi API otomatisasi akun tanpa perlu izin terpisah untuk setiap key. Gunakan hanya dengan tools yang kamu percayai.

    Jika sebuah key bocor, kembali ke API Keys, pilih Revoke API key, lalu konfirmasi Revoke. Key tersebut akan langsung berhenti berfungsi dan tidak bisa diaktifkan kembali. Buatlah key baru sebagai penggantinya jika perlu.

    Error yang umum terjadi

    • 401 Unauthorized: API key hilang, tidak valid, atau sudah dicabut (revoked).
    • 403 Forbidden: Akun kamu saat ini tidak memiliki akses Pro yang aktif.