API Reference
REST API
Setiap tier dapat memanggil API dengan plafon lajunya sendiri. Tiap endpoint di bawah menyebut tier minimum yang membukanya. Base URL: https://bandaralert.com/api/v1
Authentication
Dua metode autentikasi tersedia. Bila keduanya dikirim, Bearer JWT dipakai lebih dulu. Gunakan salah satu:
# Opsi 1: API key (disarankan) X-API-Key: ba_xxxxxxxxxxxxxxxxxxxxxxxx
# Opsi 2: JWT Bearer token (berlaku 30 menit) Authorization: Bearer <JWT_TOKEN>
Tier endpoint
- Terbuka: tanpa kredensial. Tanpa kredensial, panggilan dihitung pada plafon Free.
- Login: akun mana pun, termasuk Free.
- Pro: Pro ke atas.
- Quant: Quant dan API Pro.
Panggilan di atas tier Anda dijawab 403, dan badan jawabannya menyebut tier yang dibutuhkan.
Rate Limits
Satu jendela geser 1 jam, dihitung per akun, bukan per kunci API. Beberapa kunci API pada akun yang sama berbagi satu jatah. Saat batas tercapai, API menjawab 429 dengan header Retry-After berisi lama tunggu dalam detik.
| Tier | Permintaan per jam |
|---|---|
| Free | 300 |
| Pro | 3.000 |
| Quant | 30.000 |
| API Pro | 60.000 |
429. Beri jeda antarpermintaan pada panggilan berurutan dan ulangi setelah jeda singkat. Tidak ada response header X-RateLimit-Remaining; hitung sisa jatah dari jumlah permintaan Anda sendiri, dan baca Retry-After saat 429. Setiap tier berbayar dapat memanggil API; yang membedakan tier adalah KELAPANGAN, bukan izin. API Pro berada di dua kali plafon Quant. Jendelanya per AKUN, jadi menerbitkan lebih banyak kunci pada satu akun tidak menaikkannya. Bila Anda butuh lebih dari 60.000 per jam, tanyakan lewat Helpdesk sebelum membeli.Signals
Market Data
Stock Profile
Brokers
Computed
Broker, Insider & Corporate Data
Holders
Smart Money Tracker
Network
Backtest
Export
AI Reports
Response Format
Bentuk respons sukses TIDAK seragam di seluruh API. Tulis klien Anda mengikuti bentuk kelompok yang Anda panggil. Sebagian endpoint mengembalikan objek atau array JSON apa adanya tanpa pembungkus. Bentuk yang paling sering ditemui:
// Daftar sinyal (broker-accumulation, volume-anomaly)
{
"data": [ ... ],
"meta": { "total": 120, "limit": 50, "offset": 0, "date": "2026-10-08" }
}
// Harga (data/ohlcv)
{
"ticker": "BBCA",
"interval": "1d",
"data": [ ... ]
}
// Analitik turunan (computed/enriched-list dan sebagian rute computed)
{
"success": true,
"data": { ... }
}
// Galat dari rute data
{
"detail": {
"error": "rate_limit_exceeded",
"retry_after_seconds": 60
}
}Sebagian besar rute menaruh kode yang terbaca mesin di detail.error. Parameter yang hilang atau salah tipe dijawab 422 dengan badan berbentuk {"detail": [{"loc": [...], "msg": "...", "type": "..."}]}. Kegagalan tak terduga dijawab 500 dengan {"error": "internal_error", "message": "..."}. Tabel Error Codes di bawah memuat status HTTP-nya.
Contoh Penggunaan
import requests
from datetime import date, timedelta
API_KEY = "ba_xxxxxxxxxxxxxxxxxxxxxxxx"
BASE = "https://bandaralert.com/api/v1"
headers = {"X-API-Key": API_KEY}
# 1. Skor BASS. Kelompok ini membungkus isinya sebagai {"data": [...], "meta": {...}}
resp = requests.get(f"{BASE}/signals/broker-accumulation", headers=headers)
signals = resp.json()["data"]
for s in signals[:5]:
# Nama medannya signal_confidence, bukan confidence.
print(f"{s['ticker']}: BASS={s['bass_score']:.0f}, {s['signal_confidence']}")
# 2. Harga BBCA 30 hari terakhir -> {"ticker", "interval", "data": [...]}
# start_date wajib; tanpa itu server menjawab 422.
mulai = (date.today() - timedelta(days=30)).isoformat()
ohlcv = requests.get(
f"{BASE}/data/ohlcv/BBCA",
params={"start_date": mulai},
headers=headers,
).json()
print(f"BBCA: {len(ohlcv['data'])} titik data")
# 3. Rezim pasar. Medan keadaannya current_state, nilainya
# foreign_inflow_bull | domestic_rotation_neutral | risk_off_bear.
# probabilities adalah objek, satu angka per keadaan, bukan satu angka tunggal.
regime = requests.get(f"{BASE}/signals/market-regime", headers=headers).json()
probs = regime["probabilities"]
print(f"Rezim: {regime['current_state']} selama {regime['days_in_state']} hari")
print(f" bull={probs['bull']:.0%} neutral={probs['neutral']:.0%} bear={probs['bear']:.0%}")
# 4. Seluruh papan ke Excel dalam SATU permintaan. Ini lebih hemat kuota
# daripada memanggil per saham.
import pandas as pd
rows = requests.get(
f"{BASE}/signals/broker-accumulation",
params={"min_score": 0, "limit": 1000},
headers=headers, timeout=60,
).json()["data"]
pd.DataFrame(rows).to_excel("bandarmologi_eod.xlsx", index=False)
# 5. Rincian per kode broker, satu saham per permintaan (butuh tier Pro).
# Beri jeda antarpermintaan: permintaan beruntun yang terlalu rapat dapat
# ditolak sementara dengan HTTP 429, di luar plafon per jam akun Anda.
import time
detail = []
for r in rows:
d = requests.get(f"{BASE}/dsh/broker-summary/{r['ticker']}",
headers=headers, timeout=30)
if d.status_code == 429:
time.sleep(int(d.headers.get("Retry-After", 5)))
d = requests.get(f"{BASE}/dsh/broker-summary/{r['ticker']}",
headers=headers, timeout=30)
if d.status_code != 200:
continue
detail.append(d.json())
time.sleep(0.2)WebSocket
Sinyal pasar tidak dikirim lewat WebSocket. Ambil sinyal tersebut lewat endpoint REST di atas.
Error Codes
{"success": false, "error": "query_failed", ...}. Klien yang hanya bercabang pada status HTTP akan membacanya sebagai hasil kosong, bukan kegagalan, jadi periksa juga field success pada endpoint tersebut.https://bandaralert.com/openapi.json untuk tier Quant dan API Pro. Sertakan kredensial Anda pada permintaan: tanpa kredensial jawabannya 401, dan tier lain mendapat 403. Gunakan untuk membangkitkan SDK di bahasa apa pun dengan alat seperti openapi-generator. Penjelajah interaktif tidak disediakan.