API 문서

곡소리닷컴 API 문서

유저에게 제공되는 API는 현재 곡소리 지수를 JSON으로 반환하는 단일 endpoint입니다.

openapi.json docs.txt

빠른 시작

`GET /api/overview`를 호출합니다.
`goksorry_index` 값을 읽습니다.
`ttl_sec` 동안 같은 값을 캐시로 취급합니다.

인증 방식

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

호출 예시

curl -s "https://goksorry.com/api/overview"

지수 계산 방식

곡소리 지수는 커뮤니티 체감 지표입니다. API가 반환하는 `goksorry_index` 는 0~10 표시용 값이며 높을수록 공포, 낮을수록 희망입니다.

최근 6시간 공포/희망 글 평균을 시장 흐름으로 보정해 0~10으로 표시합니다.
내부 sentiment score는 0~10이며 높을수록 희망입니다.
중립 5에서 벗어난 정도를 1.35배 증폭한 뒤 source/종목 시장에 맞는 시장보정을 더합니다.
표시 지수 변환식: goksorry_index = clamp(5 - (score - 5) * 1.6, 0, 10)
표시 구간: 0.0~2.5 극단적 희망 · 2.6~4.5 희망 · 4.6~5.5 중립 · 5.6~7.4 공포 · 7.5~10.0 극단적 공포
높을수록 공포, 낮을수록 희망입니다.

표시 지수	구간
0.0~2.5	극단적 희망
2.6~4.5	희망
4.6~5.5	중립
5.6~7.4	공포
7.5~10.0	극단적 공포

홈 공개

현재 곡소리 지수만 반환하는 공개 API입니다.

GET/api/overview

public

현재 곡소리 지수만 조회합니다.

응답 필드	타입	설명
goksorry_index	number	0~10 표시용 곡소리 지수입니다. 높을수록 곡소리입니다.
generated_at	string	지수 계산 시각 ISO 문자열입니다.
ttl_sec	number	캐시 권장 시간(초)입니다.

응답 예시

{
  "goksorry_index": 4.8,
  "generated_at": "2026-04-08T09:30:00.000Z",
  "ttl_sec": 60
}

`goksorry_index` 는 0~10 표시용 점수이며 높을수록 곡소리입니다.
최근 6시간 공포/희망 글 평균을 시장 흐름으로 보정해 0~10으로 표시합니다.
내부 sentiment score는 0~10이며 높을수록 희망입니다.
중립 5에서 벗어난 정도를 1.35배 증폭한 뒤 source/종목 시장에 맞는 시장보정을 더합니다.
표시 지수 변환식: goksorry_index = clamp(5 - (score - 5) * 1.6, 0, 10)
표시 구간: 0.0~2.5 극단적 희망 · 2.6~4.5 희망 · 4.6~5.5 중립 · 5.6~7.4 공포 · 7.5~10.0 극단적 공포
높을수록 공포, 낮을수록 희망입니다.
`generated_at` 은 지수 계산 시각입니다.
`ttl_sec` 동안 캐시된 값으로 취급할 수 있습니다.