IDX Historical Data Engine API
Mengambil data historis saham IDX, termasuk candles, volume historis, support resistance, previous breakout, dan batch historical analysis.
Base Information
- BASE_URL_API:
https://api.maelyn.eu/api - Path / Endpoint:
/financial/idx/historical-data - Method:
POST - Credit Usage:
20
Authentication
x-maelyn-auth: YOUR_API_KEY
content-type: application/json
Description
Endpoint ini mengambil dan memproses data historis saham IDX. Karena dapat menerima banyak symbol dan konfigurasi analisis yang cukup kompleks, endpoint ini menggunakan POST dengan JSON body.
Endpoint mendukung beberapa tipe analisis: candle historis, volume historis, breakout level, batch candle historis, dan batch breakout level.
Request Body
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | Conditional | Satu kode saham. Wajib untuk tipe candles, volume, atau breakout jika symbols tidak dikirim |
symbols | array<string> | Conditional | Daftar kode saham. Maksimal 20. Cocok untuk tipe batch-candles dan batch-breakout |
type | string | No | candles, volume, breakout, batch-candles, atau batch-breakout. Default candles |
range | string | No | Rentang historis. Default 1y, khusus volume default 6mo |
interval | string | No | Interval candle, contoh 1d, 1wk, 1mo. Default 1d |
pivotLookback | number | No | Lookback pivot untuk breakout level. Default 5 |
Example Usage
1. Historical candles satu saham
POST /financial/idx/historical-data
{
"symbol": "BBCA",
"type": "candles",
"range": "1y",
"interval": "1d"
}
2. Historical volume
{
"symbol": "BBCA",
"type": "volume",
"range": "6mo"
}
3. Breakout levels
{
"symbol": "BBCA",
"type": "breakout",
"range": "1y",
"pivotLookback": 5
}
4. Batch breakout levels
{
"symbols": ["BBCA", "BBRI", "TLKM"],
"type": "batch-breakout",
"range": "1y"
}
Success Response
{
"success": true,
"data": {
"type": "breakout",
"symbol": "BBCA",
"name": "Bank Central Asia Tbk",
"range": "1y",
"resistanceLevels": [
{
"price": 10000,
"date": "2026-04-20",
"strength": "STRONG",
"touches": 3
}
],
"supportLevels": [
{
"price": 9200,
"date": "2026-03-15",
"strength": "MODERATE",
"touches": 2
}
],
"previousBreakouts": [
{
"type": "BREAKOUT_UP",
"price": 9800,
"date": "2026-02-10",
"breakoutDate": "2026-02-18",
"breakoutClose": 9900
}
],
"currentPrice": 9500,
"currentPosition": "BETWEEN_LEVELS",
"nearestResistance": 10000,
"nearestSupport": 9200,
"distToResistancePct": 5.26,
"distToSupportPct": 3.26,
"fetchedAt": "2026-05-30T10:00:00.000+07:00"
}
}
Response Fields
| Field | Type | Description |
|---|---|---|
type | string | Tipe analisis yang dijalankan |
candles | array | Data candle historis, muncul pada tipe candles |
stats | object | Statistik ringkasan candle historis |
dailyVolumes | array | Data volume harian, muncul pada tipe volume |
peakDays | array | Hari dengan volume tertinggi |
resistanceLevels | array | Daftar level resistance dari pivot high historis |
supportLevels | array | Daftar level support dari pivot low historis |
previousBreakouts | array | Breakout atau breakdown historis yang terdeteksi |
currentPosition | string | ABOVE_RESISTANCE, BELOW_SUPPORT, atau BETWEEN_LEVELS |
items | array | Data batch untuk tipe batch-candles atau batch-breakout |
Error Response
{
"success": false,
"message": "Body wajib berisi symbol atau symbols"
}