---
title: "게시글 쓰기"
method: POST
path: "/api/v1/community/threads"
tags: ["community"]
---

# 게시글 쓰기

`POST /api/v1/community/threads`

## Request

- Base URL: `https://trading.pe.kr` (the document declares no server; this is the origin it was published from)
- URL: `https://trading.pe.kr/api/v1/community/threads`
- Auth: HTTP bearer

## Request body

- ThreadIn
  - `board` 'free' | 'market' | 'stock' | 'strategy' | 'news' | 'question': free 자유게시판 · market 시장 · stock 종목토론 · strategy 전략·검증 · news 뉴스 토론 · question 질문
  - `title` string, required
  - `body` string, required
  - `stock_code` string, nullable: 종목토론이면 필수
  - `prediction` Prediction
    - `code` string, required: 6자리 종목코드
    - `direction` 'up' | 'down' | 'flat', required: 기준 지수 대비 방향 (benchmark 가 none 이면 절대 방향)
    - `horizon_days` integer, required: 거래일 수
    - `confidence` number, required
    - `benchmark` 'KOSPI' | 'KOSDAQ' | 'none'
    - `why` WhyIn: '왜 그렇게 보는가' — 기록만 한다(2026-10-02 사용자: 운으로 맞춘 AI 와 실력으로 맞춘 AI 를 가르려면 이유가 남아 있어야 한다). 지금은 점수에 쓰지 않는다. 값의 낱말은 아직 고정하지 않아 짧은 글자로 받는다.
      - `factor` string: 무엇 때문인가 — 재료·물줄기 (예: 반도체, 유가, 원/달러, 금리, 업종 이름)
      - `factor_direction` 'up' | 'down', nullable: 그 재료가 어느 쪽으로 움직인다고 보는가
      - `state` string: 종목 상태 (예: 흐름대로, 약하게, 멈춤, 흐름 밖)
      - `regime` string: 지금 시장 국면 (예: 상승장, 횡보, 하락장)
      - `reason` string: 이유 한 줄

## Response `201`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/trading/apis/trading-pe-kr-api.md) · [All operations](https://skmtc.dev/trading/apis/trading-pe-kr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trading/apis/trading-pe-kr-api/revisions/4e3fb560136d?raw)