3. K-line Data (OHLC)

Chart/Strategy Module → Market Data API (OHLC) → Chart Engine

from ssi_sdk import Auth, Data, Config
from ssi_sdk.enums import Timeframe
from ssi_sdk.exceptions import ValidationError
from auth_helper import ensure_auth

config = Config(
    client_id="<your_client_id>",
    api_key="<your_api_key>",
    api_secret="<your_api_secret>",
    private_key="<your_private_key>",
)

SYMBOL = "SSI"

with Auth(config) as auth:
    ensure_auth(auth)
    with Data(auth) as data:
        # Daily OHLC
        daily = data.market_data.get_ohlc_1day_historical(
            SYMBOL, from_date="2026/03/01 00:00:00", to_date="2026/03/27 23:59:59"
        )
        for bar in daily[:5]:
            print(f"  {bar.trading_date} | O:{bar.open_price} C:{bar.close_price} V:{bar.volume}")

        # Hourly OHLC
        hourly = data.market_data.get_ohlc_1hour(SYMBOL)

        # Paging for large datasets (1-minute)
        page, total_bars = 1, 0
        while True:
            bars = data.market_data.get_ohlc_1minute_historical(
                symbol=SYMBOL, from_date="2026/03/25 09:00:00",
                to_date="2026/03/25 15:00:00", page=page, size=100,
            )
            if not bars:
                break
            total_bars += len(bars)
            page += 1

        # SDK 3.3.0: fetch ALL bars in a range, the SDK pages for you
        # Supported timeframes: 1d, 1m, 3m, 5m, 15m, 1h
        all_bars = data.market_data.get_ohlc_all(
            SYMBOL, Timeframe.DAY_1,
            from_date="2026/01/01 00:00:00", to_date="2026/03/27 23:59:59",
            ascending=True,  # server returns newest first; ascending=True reverses to oldest -> newest
        )
        print(f"get_ohlc_all 1d: {len(all_bars)} bars")
        # iter_ohlc (generator): one bar at a time, auto paging, newest first
        count = sum(
            1
            for _ in data.market_data.iter_ohlc(
                SYMBOL, Timeframe.MINUTE_5,
                from_date="2026/03/25 09:00:00", to_date="2026/03/25 15:00:00", size=100,
            )
        )
        print(f"iter_ohlc 5m: {count} bars")

        # Weekly (1w) / monthly (1M) bars are NOT supported by the server (error 400210).
        # Since SDK 3.3.0, get_ohlc_1week_historical / get_ohlc_1month_historical raise
        # ValidationError on the client side without sending a request. Aggregate daily bars if needed.
        try:
            data.market_data.get_ohlc_1week_historical(
                SYMBOL, from_date="2026/01/01 00:00:00", to_date="2026/03/27 23:59:59"
            )
        except ValidationError as e:
            print(f"1 week not supported: {e}")

import asyncio
from ssi_sdk import AsyncAuth, AsyncData, Config
from ssi_sdk.enums import Timeframe
from auth_helper import ensure_auth_async

config = Config(...)

async def main():
    async with AsyncAuth(config) as auth:
        await ensure_auth_async(auth)
        async with AsyncData(auth) as data:
            daily = await data.market_data.get_ohlc_1day_historical(
                "SSI", from_date="2026/03/01 00:00:00", to_date="2026/03/27 23:59:59"
            )
            hourly = await data.market_data.get_ohlc_1hour("SSI")

            # SDK 3.3.0: fetch all bars, auto paging
            all_bars = await data.market_data.get_ohlc_all(
                "SSI", Timeframe.DAY_1,
                from_date="2026/01/01 00:00:00", to_date="2026/03/27 23:59:59",
                ascending=True,
            )
            # iter_ohlc is an async generator
            count = 0
            async for bar in data.market_data.iter_ohlc(
                "SSI", Timeframe.MINUTE_5,
                from_date="2026/03/25 09:00:00", to_date="2026/03/25 15:00:00", size=100,
            ):
                count += 1

asyncio.run(main())