IDX OHLCV Data Fetcher API
Mengambil data OHLCV saham IDX untuk satu atau banyak symbol menggunakan POST body agar aman untuk batch request.
Base Information
- BASE_URL_API:
https://api.maelyn.eu/api - Path / Endpoint:
/financial/idx/ohlcv - Method:
POST - Credit Usage:
15
Authentication
x-maelyn-auth: YOUR_API_KEY
content-type: application/json
Description
Endpoint ini mengambil data OHLCV saham IDX dari adapter market data. Karena endpoint ini dapat menerima banyak symbol sekaligus, method yang digunakan adalah POST agar daftar symbol dan konfigurasi request tidak membuat URL terlalu panjang.
Endpoint mendukung tiga mode utama: candles untuk satu saham, batch untuk beberapa saham dengan candle series, dan snapshot untuk snapshot harga terakhir.
Request Body
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | Conditional | Satu kode saham, contoh BBCA. Wajib jika symbols tidak dikirim |
symbols | array<string> | Conditional | Daftar kode saham. Maksimal 20. Wajib jika symbol tidak dikirim |
range | string | No | Rentang data: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y. Default 3mo |
interval | string | No | Interval candle: 1m, 5m, 15m, 1h, 1d, 1wk, 1mo. Default 1d |
mode | string | No | Mode request: candles, batch, atau snapshot. Default candles |
Example Usage
1. Candle OHLCV satu saham
POST /financial/idx/ohlcv
{
"symbol": "BBCA",
"range": "3mo",
"interval": "1d",
"mode": "candles"
}
2. Batch OHLCV beberapa saham
{
"symbols": ["BBCA", "BBRI", "TLKM"],
"range": "1mo",
"interval": "1d",
"mode": "batch"
}
3. Snapshot harga terakhir
{
"symbols": ["BBCA", "BBRI", "TLKM"],
"mode": "snapshot"
}
Success Response
{
"success": true,
"data": {
"mode": "candles",
"symbol": "BBCA",
"yahooSymbol": "BBCA.JK",
"name": "Bank Central Asia Tbk",
"sector": "Perbankan",
"currency": "IDR",
"candles": [
{
"open": 9400,
"high": 9550,
"low": 9350,
"close": 9500,
"volume": 55000000,
"timestamp": "2026-05-29T00:00:00.000+07:00",
"date": "2026-05-29",
"unixTs": 1780000000
}
],
"meta": {
"regularMarketPrice": 9500,
"regularMarketVolume": 55000000,
"chartPreviousClose": 9400,
"fiftyTwoWeekHigh": 10500,
"fiftyTwoWeekLow": 8200,
"marketCap": null
},
"fetchedAt": "2026-05-30T10:00:00.000+07:00"
}
}
Response Fields
| Field | Type | Description |
|---|---|---|
mode | string | Mode response: candles, batch, atau snapshot |
symbol | string | Kode saham IDX |
candles | array | Data OHLCV historis sesuai range dan interval |
candles.open | number | Harga pembukaan candle |
candles.high | number | Harga tertinggi candle |
candles.low | number | Harga terendah candle |
candles.close | number | Harga penutupan candle |
candles.volume | number | Volume transaksi candle |
meta.chartPreviousClose | number | Harga penutupan sebelumnya |
items | array | Data batch, muncul pada mode batch atau snapshot |
Error Response
{
"success": false,
"message": "Body wajib berisi symbol atau symbols"
}