IDX Volume Analyzer API
Menganalisis volume saham IDX, termasuk average volume, spike detection, volume trend, dan scan volume spike untuk banyak symbol.
Base Information
- BASE_URL_API:
https://api.maelyn.eu/api - Path / Endpoint:
/financial/idx/volume-analyzer - Method:
POST - Credit Usage:
15
Authentication
x-maelyn-auth: YOUR_API_KEY
content-type: application/json
Description
Endpoint ini digunakan untuk menganalisis volume saham IDX. Karena endpoint ini mendukung batch dan scan volume spike untuk banyak symbol, method yang digunakan adalah POST agar body request lebih rapi dan tidak membuat query URL terlalu panjang.
Analisis dilakukan secara statistik tanpa AI. Output meliputi rata-rata volume 5/10/20 hari, spike multiple, level spike, volume trend, dan narasi singkat.
Request Body
| Name | Type | Required | Description |
|---|---|---|---|
symbol | string | Conditional | Satu kode saham, contoh BBCA. Wajib jika symbols atau sector tidak dikirim |
symbols | array<string> | Conditional | Daftar kode saham. Maksimal 20 |
sector | string | No | Ambil symbol dari sektor tertentu, contoh Energi, Perbankan, atau all |
range | string | No | Rentang data historis. Default 3mo |
mode | string | No | Mode analisis: single, batch, atau scan-spike. Default single |
threshold | number | No | Minimum spikeMultiple untuk mode scan-spike. Default 2.0 |
Example Usage
1. Analisis volume satu saham
POST /financial/idx/volume-analyzer
{
"symbol": "BBCA",
"range": "3mo",
"mode": "single"
}
2. Batch volume analyzer
{
"symbols": ["BBCA", "BBRI", "TLKM"],
"range": "3mo",
"mode": "batch"
}
3. Scan volume spike sektor Energi
{
"sector": "Energi",
"range": "3mo",
"mode": "scan-spike",
"threshold": 2
}
Success Response
{
"success": true,
"data": {
"mode": "single",
"symbol": "BBCA",
"name": "Bank Central Asia Tbk",
"lastVolume": 55000000,
"avgVol5d": 42000000,
"avgVol10d": 39000000,
"avgVol20d": 35000000,
"maxVol20d": 70000000,
"minVol20d": 18000000,
"stdDevVol20d": 9000000,
"spikeMultiple": 1.57,
"isSpike": false,
"spikeLevel": "NORMAL",
"volumeTrend": "INCREASING",
"relativeVolume": "1.57x",
"volumeHistory": [
{
"date": "2026-05-29",
"volume": 55000000,
"vsAvg20d": 1.57
}
],
"analysis": "Volume normal namun trennya NAIK...",
"fetchedAt": "2026-05-30T10:00:00.000+07:00"
}
}
Response Fields
| Field | Type | Description |
|---|---|---|
lastVolume | number | Volume candle terakhir |
avgVol5d | number | Rata-rata volume 5 hari sebelumnya |
avgVol10d | number | Rata-rata volume 10 hari sebelumnya |
avgVol20d | number | Rata-rata volume 20 hari sebelumnya |
spikeMultiple | number | Perbandingan volume terakhir terhadap avg 20 hari |
isSpike | boolean | Bernilai true jika volume minimal 2x avg 20 hari |
spikeLevel | string | EXTREME, HIGH, MODERATE, NORMAL, atau LOW |
volumeTrend | string | INCREASING, DECREASING, atau STABLE |
items | array | Data batch atau hasil scan spike |
Error Response
{
"success": false,
"message": "Body wajib berisi symbol, symbols, atau sector"
}