News API

뉴스 기사 및 시장 업데이트에 액세스합니다.

필요 스코프: read:news 또는 read:all

뉴스 기사 목록 조회

선택적 필터링과 함께 뉴스 기사를 조회합니다.

GET /api/public/v1/news/articles

Query Parameters

파라미터	타입	설명
skip	integer	건너뛸 항목 수 (기본값: 0)
limit	integer	반환할 최대 항목 수 (1-100, 기본값: 50)
category	string	카테고리별 필터링
priority	integer	우선순위별 필터링 (1=높음, 2=중간, 3=낮음)

Headers

헤더	설명
x-locale	언어 코드: ko, en, ja, zh (기본값: en)

요청 예시

curl -X GET "https://api.alpha-lenz.com/api/public/v1/news/articles?limit=20&category=market_move" \
     -H "X-API-Key: ak_your_key" \
     -H "x-locale: ko"

응답

{
  "articles": [
    {
      "id": 123,
      "title": "Major Market Movement: Tech Stocks Rally",
      "summary": "Technology stocks led the market rally today...",
      "category": "market_move",
      "priority": 1,
      "source_url": "https://example.com/article",
      "published_at": "2024-01-15T14:30:00Z",
      "created_at": "2024-01-15T14:35:00Z"
    }
  ],
  "total": 150,
  "skip": 0,
  "limit": 20
}

---

뉴스 기사 조회

특정 뉴스 기사의 상세 정보를 조회합니다.

GET /api/public/v1/news/articles/{article_id}

Path Parameters

파라미터	타입	설명
article_id	integer	뉴스 기사 ID

요청 예시

curl -X GET "https://api.alpha-lenz.com/api/public/v1/news/articles/123" \
     -H "X-API-Key: ak_your_key" \
     -H "x-locale: en"

응답

{
  "id": 123,
  "title": "Major Market Movement: Tech Stocks Rally",
  "summary": "Technology stocks led the market rally today...",
  "ai_angle": "AI analysis perspective on the market movement...",
  "risk": "Key risks to watch...",
  "category": "market_move",
  "priority": 1,
  "source_url": "https://example.com/article",
  "trigger": [
    {
      "topic": "Tech Stocks",
      "sentiment": "positive"
    }
  ],
  "published_at": "2024-01-15T14:30:00Z",
  "created_at": "2024-01-15T14:35:00Z"
}

---

기사 전문 조회

뉴스 기사의 전체 콘텐츠를 조회합니다.

GET /api/public/v1/news/articles/{article_id}/content

Path Parameters

파라미터	타입	설명
article_id	integer	뉴스 기사 ID

요청 예시

curl -X GET "https://api.alpha-lenz.com/api/public/v1/news/articles/123/content" \
     -H "X-API-Key: ak_your_key" \
     -H "x-locale: ko"

응답

{
  "id": 123,
  "title": "Major Market Movement: Tech Stocks Rally",
  "content_type": "html",
  "full_content": "<div>Full article content here...</div>"
}

카테고리

사용 가능한 뉴스 카테고리:

카테고리	설명
eod_summary	장 마감 시장 요약
fed_policy	연방준비제도 정책 업데이트
market_move	주요 시장 움직임
earnings	실적 발표
breaking	속보

언어 지원

x-locale 헤더를 사용하여 현지화된 콘텐츠를 받을 수 있습니다:

• ko - 한국어

• en - 영어 (기본값)

• ja - 일본어

• zh - 중국어