Stock

Access stock price data including OHLCV (Open, High, Low, Close, Volume).

Required Scope: read:stock or read:all

Get Stock Prices

Get OHLCV stock price data for a symbol.

GET /api/public/v1/stock/prices/{symbol}

Path Parameters

Parameter	Type	Description
symbol	string	Stock symbol (e.g., "005930")

Query Parameters

Parameter	Type	Description
interval	string	Time interval: "1day", "1week", "1month" (default: "1day")
limit	integer	Number of data points (1-500, default: 100)

Example Request

curl -X GET "https://api.alpha-lenz.com/api/public/v1/stock/prices/005930?interval=1day&limit=30" \
     -H "X-API-Key: ak_your_key"

Response

{
  "symbol": "005930",
  "company_name": "Samsung Electronics",
  "interval": "1day",
  "data": [
    {
      "datetime": "2024-01-15T00:00:00",
      "open": 71500.0,
      "high": 72000.0,
      "low": 71000.0,
      "close": 71800.0,
      "volume": 15000000
    },
    {
      "datetime": "2024-01-16T00:00:00",
      "open": 71800.0,
      "high": 72500.0,
      "low": 71500.0,
      "close": 72200.0,
      "volume": 12500000
    }
  ],
  "count": 30
}

---

Get Stock Price History

Get historical stock price data with date filtering and pagination.

GET /api/public/v1/stock/prices/{symbol}/history

Path Parameters

Parameter	Type	Description
symbol	string	Stock symbol

Query Parameters

Parameter	Type	Description
interval	string	Time interval: "1day", "1week", "1month"
start_date	string	Start date filter (YYYY-MM-DD)
end_date	string	End date filter (YYYY-MM-DD)
page	integer	Page number (starts from 1, default: 1)
limit	integer	Results per page (1-1000, default: 100)

Example Request

curl -X GET "https://api.alpha-lenz.com/api/public/v1/stock/prices/005930/history?start_date=2024-01-01&end_date=2024-01-31&page=1&limit=100" \
     -H "X-API-Key: ak_your_key"

Response

{
  "symbol": "005930",
  "company_name": "Samsung Electronics",
  "interval": "1day",
  "data": [
    {
      "datetime": "2024-01-02T00:00:00",
      "open": 70000.0,
      "high": 71000.0,
      "low": 69500.0,
      "close": 70500.0,
      "volume": 18000000
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 100,
    "total": 22,
    "total_pages": 1,
    "has_next": false,
    "has_prev": false
  }
}

OHLCV Fields

Field	Type	Description
datetime	string	ISO 8601 datetime
open	float	Opening price
high	float	Highest price
low	float	Lowest price
close	float	Closing price
volume	integer	Trading volume

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

Example Pagination

# First page
GET /stock/prices/005930/history?page=1&limit=100

# Second page
GET /stock/prices/005930/history?page=2&limit=100