곡소리닷컴 API 문서

홈 커뮤니티 카드의 원감성 점수와 표시용 곡소리 지수를 조회합니다.

{
  "generated_at": "2026-04-08T09:30:00.000Z",
  "market_adjustment_enabled": true,
  "overall_base_score": 5.4,
  "overall_market_adjustment": -0.32,
  "overall_sentiment_score": 5.1,
  "overall_goksorry_index": 5.4,
  "overall_sentiment_band": "neutral",
  "community_indicators": [
    {
      "id": "ppomppu",
      "label": "뽐뿌 증권포럼 지수",
      "shortLabel": "뽐뿌",
      "mentions": 8,
      "bullish": 5,
      "bearish": 3,
      "neutral": 4,
      "base_score": 5.6,
      "market_adjustment": -0.21,
      "score": 5.4,
      "goksorry_index": 5.1,
      "sentiment_band": "neutral",
      "tone": "mixed",
      "rows": [
        {
          "post_key": "ppomppu:12345",
          "source": "ppomppu_stock",
          "title": "오늘 국장 반등 보시나요",
          "clean_title": "오늘 국장 반등 보시나요",
          "url": "https://www.ppomppu.co.kr/zboard/view.php?id=stock&no=12345",
          "symbol": null,
          "symbol_name": null,
          "symbol_market": null,
          "label": "bullish",
          "sentiment_score": 7,
          "confidence": 0.82,
          "analyzed_at": "2026-04-08T09:28:00.000Z"
        }
      ]
    }
  ]
}

• 홈 상단 커뮤니티 카드와 동일한 집계 결과입니다.
• `overall_sentiment_score` 와 각 섹션의 `score` 는 내부 원감성 점수이며 높을수록 희망입니다.
• `overall_goksorry_index` 와 각 섹션의 `goksorry_index` 는 홈 표시용 반전 점수이며 높을수록 곡소리입니다.
• 소스 그룹은 토스증권, 뽐뿌, 블라인드, 디시 4종으로 고정됩니다.

홈 상단 시장 지표와 원감성 점수, 표시용 곡소리 지수를 함께 조회합니다.

{
  "generated_at": "2026-04-08T09:30:00.000Z",
  "market_indicators": [
    {
      "id": "kospi",
      "label": "KOSPI",
      "value_text": "2,732.11",
      "delta_text": "+18.42 (+0.68%)",
      "change_value": 18.42,
      "change_percent": 0.68,
      "tone": "up",
      "note": ""
    },
    {
      "id": "usdkrw",
      "label": "원/달러 환율",
      "value_text": "1,351.20",
      "delta_text": "+4.10 KRW (+0.30%)",
      "change_value": 4.1,
      "change_percent": 0.3,
      "tone": "up",
      "note": "네이버 환율"
    }
  ],
  "market_adjustment_enabled": true,
  "overall_base_score": 5.4,
  "overall_market_adjustment": -0.32,
  "overall_sentiment_score": 5.1,
  "overall_goksorry_index": 5.4,
  "overall_sentiment_band": "neutral",
  "community_indicators": [
    {
      "id": "ppomppu",
      "label": "뽐뿌 증권포럼 지수",
      "shortLabel": "뽐뿌",
      "mentions": 8,
      "bullish": 5,
      "bearish": 3,
      "neutral": 4,
      "base_score": 5.6,
      "market_adjustment": -0.21,
      "score": 5.4,
      "goksorry_index": 5.1,
      "sentiment_band": "neutral",
      "tone": "mixed",
      "rows": [
        {
          "post_key": "ppomppu:12345",
          "source": "ppomppu_stock",
          "title": "오늘 국장 반등 보시나요",
          "clean_title": "오늘 국장 반등 보시나요",
          "url": "https://www.ppomppu.co.kr/zboard/view.php?id=stock&no=12345",
          "symbol": null,
          "symbol_name": null,
          "symbol_market": null,
          "label": "bullish",
          "sentiment_score": 7,
          "confidence": 0.82,
          "analyzed_at": "2026-04-08T09:28:00.000Z"
        }
      ]
    }
  ]
}

• `/api/community-indicators` 응답에 KOSPI, KOSDAQ, NASDAQ, 원/달러 환율 요약을 추가한 형태입니다.
• `overall_sentiment_score`/`score` 는 원감성 점수, `overall_goksorry_index`/`goksorry_index` 는 홈 표시용 곡소리 지수입니다.
• 시장 지표와 커뮤니티 지수를 한 번에 받아야 하는 외부 클라이언트용 요약 엔드포인트입니다.

서비스 상태와 배포 버전을 확인합니다.

{
  "status": "ok",
  "time": "2026-03-11T10:00:00.000Z",
  "version": "1.0.0"
}

• 인증 없이 호출할 수 있습니다.

한국·미국 시장의 최신 커뮤니티 기반 종목 신호를 조회합니다.

{
  "status": "ok",
  "generated_at": "2026-03-11T10:00:00.000Z",
  "detector_mode": "normal",
  "signals": [
    {
      "symbol": "AAPL",
      "market": "us",
      "asof": "2026-03-11T09:57:00.000Z",
      "freshness_sec": 180,
      "mentions": 42,
      "neg_count": 11,
      "pos_count": 20,
      "panic_score": 26.19,
      "euphoria_score": 47.62,
      "signal_quality": 0.81,
      "mention_velocity_z": 0,
      "confidence_grade": "A",
      "source_diversity": 3
    }
  ],
  "missing_symbols": [],
  "ttl_sec": 60
}

• 이 API는 커뮤니티에서 파생된 신호만 제공합니다.
• 공식 시세, 지수, 거시 지표 원데이터는 봇이 별도로 수집해야 합니다.

특정 종목 하나의 최신 신호 스냅샷을 조회합니다.

{
  "symbol": "AAPL",
  "market": "us",
  "latest": {
    "symbol": "AAPL",
    "market": "us",
    "asof": "2026-03-11T09:57:00.000Z",
    "freshness_sec": 180,
    "mentions": 42,
    "neg_count": 11,
    "pos_count": 20,
    "panic_score": 26.19,
    "euphoria_score": 47.62,
    "signal_quality": 0.81,
    "mention_velocity_z": 0,
    "confidence_grade": "A",
    "source_diversity": 3
  },
  "window": {
    "long_min": 120,
    "short_min": 20
  }
}

시장 단위의 최신 커뮤니티 레짐과 공포 지수를 조회합니다.

{
  "status": "ok",
  "generated_at": "2026-03-11T10:00:00.000Z",
  "markets": [
    {
      "market": "kr",
      "asof": "2026-03-11T09:58:00.000Z",
      "regime": "risk_off",
      "fear_index": 67.5,
      "payload": {
        "avg_euphoria": 31.2,
        "avg_sentiment_score": 3.84,
        "symbol_count": 18,
        "pos_count": 42,
        "neg_count": 71,
        "neutral_count": 19,
        "actionable_count": 113,
        "dominant_share": 0.6283,
        "regime_basis": "post_dominance_v1"
      }
    }
  ],
  "ttl_sec": 60
}

• 레짐과 공포 지수는 공식 거래소 지표가 아니라 커뮤니티 활동에서 파생된 값입니다.
• regime은 최근 수집 글의 bullish/bearish 우세로 계산하고, fear_index는 평균 sentiment score에서 파생합니다.

봇 측 안전 점검을 위한 detector 파이프라인 상태를 조회합니다.

{
  "status": "ok",
  "detector_mode": "normal",
  "collector": {
    "last_run_at": "2026-03-11T09:59:00.000Z",
    "errors": 0
  },
  "llm": {
    "provider": "gemini",
    "last_run_at": "2026-03-11T09:59:00.000Z",
    "degraded": false
  },
  "sources": {
    "us_cooldown_until": null,
    "hold_list": []
  }
}