IDX Watchlist Alert API
Pantau daftar saham watchlist kamu terhadap target harga. FLARIA AI memberikan review status alert, rekomendasi aksi, dan update berita terkini untuk setiap saham di watchlist.
Base Information
- BASE_URL_API:
https://api.maelyn.eu/api - Path / Endpoint:
/financial/idx/watchlist-alert - Method:
POST - Credit Usage:
25
Authentication
x-maelyn-auth: YOUR_API_KEY
Content-Type: application/json
Description
Endpoint ini menerima daftar saham watchlist beserta target harga masing-masing, kemudian mengambil harga pasar terkini dan menghitung gap antara harga saat ini dengan target. FLARIA AI memberikan review status alert (Triggered, Near, Watch, atau Far) dan rekomendasi aksi berdasarkan kondisi teknikal serta berita terbaru masing-masing saham.
Batas: maksimal 10 saham per request.
Request Body
{
"watchlist": [
{ "symbol": "BBCA", "target_price": 10000 },
{ "symbol": "TLKM", "target_price": 3200 },
{ "symbol": "ADRO", "target_price": 3000 }
]
}
Body Parameters
| Name | Type | Required | Description |
|---|---|---|---|
watchlist | array | Yes | Daftar saham, minimal 1 dan maksimal 10 |
watchlist[].symbol | string | Yes | Kode saham IDX. Contoh: BBCA |
watchlist[].target_price | number | Yes | Target harga dalam IDR per lembar |
Alert Status Logic
| Status | Kondisi |
|---|---|
Triggered | Harga sudah mencapai atau melewati target price |
Near | Harga < 5% dari target |
Watch | Harga dalam jarak 5–15% dari target |
Far | Harga lebih dari 15% dari target |
Example Usage
{
"watchlist": [
{ "symbol": "BBCA", "target_price": 10000 },
{ "symbol": "GOTO", "target_price": 100 },
{ "symbol": "ADRO", "target_price": 3000 },
{ "symbol": "TLKM", "target_price": 3500 }
]
}
Success Response
{
"success": true,
"data": {
"total_watched": 4,
"total_processed": 4,
"total_error": 0,
"market_snapshot": [
{
"symbol": "BBCA",
"current_price": 9650,
"target_price": 10000,
"gap_pct": 3.63,
"rsi_14": 54.32,
"error": null
},
{
"symbol": "GOTO",
"current_price": 68,
"target_price": 100,
"gap_pct": 47.06,
"rsi_14": 32.1,
"error": null
}
],
"ai_review": {
"review": [
{
"symbol": "BBCA",
"status_alert": "Near",
"aksi_disarankan": "Pertahankan, harga mendekati target. Pertimbangkan jual sebagian di 9.900",
"berita_terkini": "Laba Q1 BBCA tumbuh 12% YoY, sentimen positif",
"update_target": "Target 10.000 masih realistis dalam 1–2 bulan"
},
{
"symbol": "GOTO",
"status_alert": "Far",
"aksi_disarankan": "Sabar, masih jauh dari target. Evaluasi ulang jika kondisi fundamental berubah",
"berita_terkini": "GOTO terus fokus efisiensi cost, GMV tumbuh 15% QoQ",
"update_target": "Pertahankan target 100, timeline 6–12 bulan"
}
],
"summary": "2 saham dalam kondisi normal, BBCA paling mendekati target...",
"disclaimer": "Analisis ini bukan saran investasi resmi.",
"sources": []
}
}
}
Response Fields
| Field | Type | Description |
|---|---|---|
market_snapshot | array | Snapshot harga terkini vs target untuk setiap saham |
gap_pct | number | Persentase jarak harga terkini ke target (positif = target di atas) |
ai_review.review | array | Review status dan rekomendasi per saham dari FLARIA AI |
status_alert | string | Triggered, Near, Watch, atau Far |
aksi_disarankan | string | Rekomendasi aksi dari FLARIA AI |
update_target | string | Saran apakah target perlu direvisi |
Error Response
Melebihi batas watchlist
{
"success": false,
"message": "Maksimal 10 saham per request. Kamu mengirim 12."
}
Format watchlist salah
{
"success": false,
"message": "Field \"watchlist\" wajib berupa array dan tidak boleh kosong."
}
Target price tidak diisi
{
"success": false,
"message": "Item \"BBCA\" wajib memiliki \"target_price\" (number)."
}