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
page	integer	Page number (starts from 1, default: 1)
limit	integer	Results per page (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?page=1&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"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "total_pages": 8,
    "has_next": true,
    "has_prev": false
  }
}

### Pagination Response Fields

| Field | Type | Description |
|-------|------|-------------|
| `page` | integer | Current page number |
| `limit` | integer | Items per page |
| `total` | integer | Total number of items |
| `total_pages` | integer | Total number of pages |
| `has_next` | boolean | Whether next page exists |
| `has_prev` | boolean | Whether previous page exists |

---

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