IDX Top Gainer & Loser API

Scan seluruh universe saham IDX dan ranking berdasarkan perubahan harga harian. Mengembalikan top gainer dan loser beserta AI insight katalis pergerakan dari FLARIA.

Base Information

BASE_URL_API: https://api.maelyn.eu/api
Path / Endpoint: /financial/idx/top-mover
Method: GET
Credit Usage: 20

Authentication

x-maelyn-auth: YOUR_API_KEY

Description

Endpoint ini melakukan scan seluruh universe saham IDX (atau per sektor) dan mengurutkan berdasarkan persentase perubahan harga harian. Mengembalikan top N gainer dan loser beserta data teknikal masing-masing, statistik breadth pasar, dan insight dari FLARIA AI mengenai katalis yang mendorong pergerakan.

Query Parameters

Name	Type	Required	Description
`top`	`number`	No	Jumlah gainer/loser yang ditampilkan. Maksimal `15`, default `10`
`sector`	`string`	No	Filter sektor: `Perbankan` `Energi` `Consumer` `Teknologi` `Infrastruktur` `Properti` `Healthcare` `all`. Default: `all`
`ai`	`string`	No	Aktifkan AI insight: `true` atau `false`. Default: `true`

Example Usage

1. Top 10 gainer/loser semua sektor

GET /financial/idx/top-mover

2. Top 5 gainer/loser sektor Energi

GET /financial/idx/top-mover?top=5&sector=Energi

3. Tanpa AI (lebih cepat)

GET /financial/idx/top-mover?ai=false

Success Response

{
  "success": true,
  "data": {
    "sector": "all",
    "total_scanned": 42,
    "market_summary": {
      "advancing": 28,
      "declining": 11,
      "unchanged": 3,
      "avg_change": 0.45,
      "market_breadth": "BULLISH"
    },
    "gainers": [
      {
        "symbol": "ADRO",
        "price": 2850,
        "prevClose": 2750,
        "change": 3.64,
        "volume": 48000000,
        "rsi": 61.2,
        "momentum5d": 4.5,
        "trend": "UP",
        "macd_signal": "Bullish",
        "high52w": 3100,
        "low52w": 2200
      }
    ],
    "losers": [
      {
        "symbol": "WSKT",
        "price": 148,
        "prevClose": 158,
        "change": -6.33,
        "volume": 22000000,
        "rsi": 28.4,
        "momentum5d": -8.2,
        "trend": "DOWN",
        "macd_signal": "Bearish",
        "high52w": 210,
        "low52w": 130
      }
    ],
    "ai": {
      "data": {
        "insight_gainer": "ADRO naik didorong kenaikan harga batu bara global...",
        "insight_loser": "WSKT tertekan isu restrukturisasi utang...",
        "katalis_utama": ["Harga komoditas naik", "Sentimen negatif BUMN konstruksi"],
        "rekomendasi": "Fokus akumulasi di sektor komoditas jangka pendek.",
        "disclaimer": "Analisis ini bukan saran investasi resmi."
      },
      "sources": []
    }
  }
}

Response Fields

Field	Type	Description
`market_summary.advancing`	`number`	Jumlah saham yang naik hari ini
`market_summary.declining`	`number`	Jumlah saham yang turun hari ini
`market_summary.market_breadth`	`string`	`BULLISH`, `BEARISH`, atau `MIXED`
`gainers`	`array`	Daftar top gainer diurutkan dari kenaikan terbesar
`losers`	`array`	Daftar top loser diurutkan dari penurunan terbesar
`ai.insight_gainer`	`string`	Analisis katalis pergerakan saham gainer
`ai.insight_loser`	`string`	Analisis katalis pergerakan saham loser

Error Response

{
  "success": false,
  "message": "Internal server error"
}

Playground

Stock Compare Watchlist Alert