IDX Sentiment Aggregator API

Mengagregasi sentimen saham IDX dari berita keuangan Indonesia dan komunitas investor. Menghasilkan skor sentimen -100 hingga +100, label, kata kunci trending, dan implikasi harga. Mendukung perbandingan dua saham.

Base Information

  • BASE_URL_API: https://api.maelyn.eu/api
  • Path / Endpoint: /financial/idx/sentiment-aggregator
  • Method: GET
  • Credit Usage: 20

Authentication

x-maelyn-auth: YOUR_API_KEY

Description

Endpoint ini menggunakan FLARIA AI dengan Google Search Grounding untuk mengagregasi sentimen dari berita keuangan Indonesia (CNBC Indonesia, Bisnis.com, Kontan, IDX, dll) dan komunitas investor. Menghasilkan skor sentimen -100 sampai +100, label sentimen, kata kunci trending, tone media, perubahan sentimen vs minggu lalu, dan implikasi harga jangka pendek. Mendukung mode perbandingan dua saham sekaligus.

Query Parameters

NameTypeRequiredDescription
symbolstringYesKode saham IDX utama. Contoh: BBCA
comparestringNoKode saham pembanding. Jika diisi, aktifkan mode perbandingan. Contoh: BBRI

Example Usage

1. Sentimen tunggal

GET /financial/idx/sentiment-aggregator?symbol=BBCA

2. Perbandingan sentimen dua saham

GET /financial/idx/sentiment-aggregator?symbol=BBCA&compare=BBRI

Success Response — Single Mode

{
  "success": true,
  "data": {
    "symbol": "BBCA",
    "price_context": {
      "price": 9650,
      "change": 0.52,
      "rsi": "54.32"
    },
    "sentiment": {
      "symbol": "BBCA",
      "tanggal": "28 Mei 2026",
      "skor_sentimen": 65,
      "label_sentimen": "BULLISH",
      "berita_positif": [
        {
          "judul": "BBCA Cetak Laba Q1 2026 Tumbuh 12% YoY",
          "sumber": "Kontan.co.id",
          "ringkasan": "Laba bersih BBCA Q1 2026 tercatat Rp 12,3 triliun...",
          "bobot": "High"
        }
      ],
      "berita_negatif": [],
      "kata_kunci_trending": ["BBCA", "laba", "dividen", "BI Rate"],
      "sentimen_komunitas": "Mayoritas investor ritel bullish menjelang RUPS...",
      "tone_media": "Positif",
      "perubahan_sentimen": "Membaik",
      "katalis_utama": "Laba Q1 melampaui ekspektasi analis",
      "risiko_sentimen": "Potensi profit taking setelah kenaikan harga signifikan",
      "implikasi_harga_jangka_pendek": "Harga berpotensi menguji resistance 9.800–9.850",
      "disclaimer": "Analisis ini bukan saran investasi resmi."
    },
    "sources": []
  }
}

Success Response — Compare Mode

{
  "success": true,
  "data": {
    "mode": "compare",
    "symbols": ["BBCA", "BBRI"],
    "comparison": {
      "BBCA": {
        "price_context": { "price": 9650, "change": 0.52, "rsi": "54.32" },
        "sentiment": { "skor_sentimen": 65, "label_sentimen": "BULLISH" },
        "sources": []
      },
      "BBRI": {
        "price_context": { "price": 5075, "change": -0.2, "rsi": "48.10" },
        "sentiment": { "skor_sentimen": 40, "label_sentimen": "NEUTRAL" },
        "sources": []
      }
    },
    "winner_by_sentiment": "BBCA",
    "score_diff": 25
  }
}

Response Fields

FieldTypeDescription
skor_sentimennumberSkor sentimen dari -100 (very bearish) hingga +100 (very bullish)
label_sentimenstringVERY_BULLISH, BULLISH, NEUTRAL, BEARISH, atau VERY_BEARISH
berita_positifarrayBerita dengan dampak positif beserta bobotnya
tone_mediastringPositif, Netral, atau Negatif
perubahan_sentimenstringMembaik, Stabil, atau Memburuk
winner_by_sentimentstring(Mode compare) Saham dengan sentimen lebih baik, atau DRAW
score_diffnumber(Mode compare) Selisih skor sentimen antar dua saham

Error Response

{
  "success": false,
  "message": "Query param \"symbol\" wajib diisi. Contoh: ?symbol=BBCA"
}

Playground