News

Access news articles and market updates.

Required Scope: read:news or read:all

List News Articles

Get news articles with optional filtering.

GET /api/public/v1/news/articles

Query Parameters

Parameter	Type	Description
skip	integer	Items to skip (default: 0)
limit	integer	Max items to return (1-100, default: 50)
category	string	Filter by category
priority	integer	Filter by priority (1=high, 2=medium, 3=low)

Headers

Header	Description
x-locale	Language code: ko, en, ja, zh (default: en)

Example Request

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"

Response

{
  "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 News Article

Get detailed information about a specific news article.

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

Path Parameters

Parameter	Type	Description
article_id	integer	News article ID

Example Request

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"

Response

{
  "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 Article Full Content

Get the full content of a news article.

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

Path Parameters

Parameter	Type	Description
article_id	integer	News article ID

Example Request

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"

Response

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

Categories

Available news categories:

Category	Description
eod_summary	End of day market summary
fed_policy	Federal Reserve policy updates
market_move	Significant market movements
earnings	Earnings reports
breaking	Breaking news

Language Support

Use the x-locale header to get localized content:

• ko - Korean

• en - English (default)

• ja - Japanese

• zh - Chinese