Limit & Kuota

Untuk menjamin penggunaan yang adil dan stabilitas layanan, Index Alpha API memberlakukan batasan berikut:

Cakupan Data

• Data tersedia sejak 2025-01-01 untuk Pasar Reguler (RG) dan Pasar Negosiasi (NG).
• Permintaan dengan tanggal from sebelum 2025-01-01 ditolak dengan error 400.
• Rentang tanggal: satu permintaan dapat mencakup maksimal 366 hari (from hingga to).
• Ukuran batch: maksimal 50 ticker per batch request.
• Data yang lebih lama mungkin tersedia pada paket Enterprise; hubungi dukungan di @neon_scale untuk akses.

Rate Limit

Rate limit bergantung pada paket Anda saat ini:

• Paket Free: 10 permintaan per menit.
• Paket Starter: 120 permintaan per menit.
• Paket Professional: 300 permintaan per menit.
• Paket Advanced: 500 permintaan per menit.
• Paket Enterprise: Rate limit kustom berdasarkan kesepakatan Anda.

Jika Anda melampaui batas ini, API mengembalikan error 429 Too Many Requests. Response header (X-RateLimit-*) menyediakan status real-time sisa window Anda.

Kuota Bulanan

Akun Anda memiliki batas bulanan bersama di semua API key di bawahnya:

• Paket Free: 5 permintaan per hari.
• Paket Starter: 25.000 permintaan per bulan.
• Paket Professional: 100.000 permintaan per bulan.
• Paket Advanced: 250.000 permintaan per bulan.
• Paket Enterprise: Batas penggunaan kustom berdasarkan kesepakatan Anda.

Paket multi-bulan

Starter dan Professional juga tersedia sebagai langganan 3-bulan dan 6-bulan dengan diskon ~17% dari harga bulanan. Kuota bulanan direset setiap 30 hari selama periode berlangsung:

Sebagai contoh, langganan Starter 3M menerima 25.000 permintaan untuk hari 1-30, 25.000 lagi untuk hari 31-60, dan 25.000 lagi untuk hari 61-90. Kuota yang tidak terpakai tidak dialihkan ke window berikutnya. Membeli ulang paket kapan pun memperpanjang periode aktif Anda; kuota bulanan Anda tetap direset pada siklus 30-hari Anda.

• Cek Penggunaan: Gunakan endpoint /usage untuk melihat penggunaan tingkat key maupun tingkat akun.
• Reset: Kuota direset otomatis di awal setiap siklus 30-hari.

Cara penghitungan penggunaan

Penghitung kuota Anda ditambah secara sinkron pada setiap panggilan API yang berhasil (HTTP 200). Error (400, 403, 500) tidak dihitung.

Mengecek penggunaan dengan GET /usage selalu gratis dan tidak pernah mengonsumsi kuota.

Sebagai contoh, satu batch call dengan 50 ticker mengonsumsi 50 unit dari kuota bulanan Anda - sama dengan 50 panggilan single-ticker terpisah.

Permintaan identik yang berulang dalam jangka waktu singkat (30 detik) dapat dilayani dari cache. Respons yang dilayani dari cache tetap dihitung ke kuota Anda - setiap permintaan yang berhasil mengonsumsi kuota tepat satu kali, baik dilayani dari cache maupun tidak. Hanya permintaan yang ditolak karena error yang gratis.

Endpoint MCP menggunakan key khusus yang dibuat otomatis untuk akun Anda. Key ini tidak dihitung dalam batas key paket Anda dan ditampilkan di dashboard di bawah "MCP Access".

Penghitung ditambah secara atomik di database. Jika akun Anda sudah berada di batas, permintaan ditolak sebelum pekerjaan lain dilakukan - tidak ada biaya parsial, tidak ada kelebihan pemakaian.

Yang terjadi saat Anda mencapai batas

Dua batas berbeda dapat memblokir sebuah permintaan. Masing-masing mengembalikan error yang berbeda:

Kuota bulanan habis

Ketika akun Anda mencapai kuota bulanannya, panggilan API berikutnya mengembalikan:

{
  "detail": "Account monthly API limit exceeded"
}

dengan X-Monthly-Remaining: 0. Response header X-Monthly-Reset pada setiap panggilan menunjukkan timestamp reset kuota Anda berikutnya.

Anda dapat memantau sisa kuota secara real-time melalui response header X-Monthly-Remaining pada setiap panggilan API, atau mengecek endpoint /usage.

Pilihan Anda

Upgrade ke tingkat lebih tinggi - Paket tingkat lebih tinggi memiliki kuota lebih besar dan rate limit lebih cepat. Anda dapat upgrade ke tingkat dan durasi apa pun (1, 3, atau 6 bulan) secara langsung: Anda membayar harga paket baru dikurangi nilai yang belum terpakai dari periode Anda saat ini, dan kuota serta periode Anda direset sesuai durasi baru. Lihat halaman harga atau hubungi sales untuk opsi Enterprise.

Tunggu window berikutnya - Kuota Anda direset otomatis di awal setiap window 30-hari. Pada paket 3M/6M hal ini terjadi sebelum periode Anda berakhir, sehingga Anda cukup menunggu. Pada paket bulanan, periode Anda dan siklus kuota Anda berakhir bersamaan, sehingga perpanjangan harus dilakukan lebih dulu untuk menjaga akses. Cek tanggal reset Anda di dashboard.

Penawaran kustom - Jika admin telah menetapkan penawaran kustom ke akun Anda (dengan batas lebih tinggi), penawaran tersebut muncul di halaman harga setelah Anda masuk.

Memperpanjang paket Anda

Perpanjangan berkaitan dengan menjaga akun Anda tetap aktif, bukan mengisi ulang kuota. Membayar paket yang sama lagi memperpanjang periode aktif Anda sesuai durasinya; kuota bulanan Anda tetap hanya direset pada siklus 30-hari Anda. Jika Anda telah menghabiskan kuota siklus ini, memperpanjang tidak akan memberikan permintaan tambahan - lakukan upgrade sebagai gantinya, atau tunggu window berikutnya.

Sebagai contoh, pelanggan Professional memperpanjang 10 hari sebelum periodenya berakhir:

Plan:                   Professional
Price paid:            Rp350,000
Renewal on:            day 20 of the current 30-day cycle
What changes:          periodEnd extends by 30 days
Quota:                 unchanged - still 100,000, resets at the cycle boundary

Perpanjangan tidak dapat membuat total periode aktif melebihi 180 hari dari sekarang. Jika periode saat ini sudah mendekati 6 bulan, perpanjangan akan ditolak — silakan perpanjang mendekati masa kedaluwarsa.

Upgrade Paket

Upgrade berlaku segera untuk tingkat dan durasi apa pun (1, 3, atau 6 bulan). Anda membayar harga penuh paket baru dikurangi nilai yang belum terpakai dari periode Anda saat ini - sisa hari Anda dikreditkan dengan tarif harian paket Anda saat ini - dan kuota serta periode Anda direset sesuai durasi baru. periodEnd Anda saat ini tidak dipertahankan pada saat upgrade.

Contoh Upgrade

Paket awal:

Plan: Starter 3M
Price paid: Rp500,000
Period: Jan 1 → Apr 1 (90 days)
Remaining days at upgrade: 45
Quota: 25,000 per 30-day cycle

Peristiwa upgrade:

Upgrade to: Professional 3M
Price: Rp875,000 / 90 days
Daily rate Starter 3M: 500,000 / 90 = Rp5,556
Unused Starter value:  5,556 × 45 ≈ Rp250,000
Charge:                875,000 − 250,000 ≈ Rp625,000 (rounded down to the nearest Rp1,000)

Setelah upgrade:

Plan: Professional 3M
Rate limit: 300 req/min
Quota: 100,000 per 30-day cycle (fresh)
period: fresh 90 days from today

Nilai Starter yang belum terpakai Anda dikreditkan ke harga paket baru; Anda membayar selisihnya dan memulai periode baru dengan durasi baru. Downgrade tidak diizinkan selama periode langganan aktif.

Paket Kustom

Paket kustom adalah penawaran privat yang ditetapkan ke akun Anda. Jika Anda menerima penawaran kustom, penawaran tersebut muncul di halaman harga setelah Anda masuk.

Jika penawaran kustom Anda bersifat berulang (recurring), penawaran pembayaran berikutnya dibuat secara otomatis setelah Anda membayar. Penawaran tersebut muncul di halaman harga segera, sehingga Anda dapat membelinya lebih awal untuk memperpanjang masa validitas Anda tanpa menunggu periode kustom aktif berakhir.

Sebagai contoh, penawaran kustom 30-hari yang berulang bekerja seperti ini:

May 2: You pay Custom 100K for 30 days.
May 2 to June 1: Your Custom 100K subscription is active.
May 2: The next Custom 100K payment offer appears automatically.
May 10: You pay the next offer early.
June 1 to July 1: The early payment extends your Custom 100K validity for the next 30-day period.