sysstra-data

Lightweight, generalized market data client for the Sysstra trading platform. Wraps sysstra-data-services with a typed, domain-namespaced Python interface.

Install

pip install sysstra-data

Quickstart

from sysstra_data import SysstraData

client = SysstraData(api_key="sk-...")

# Equities
eod = client.equities.eod("SBIN", "2025-01-01", "2025-06-30", exchange="XNSE")
intraday = client.equities.candles("SBIN", "2025-01-01", "2025-01-02", interval=5)

# Futures & Options
futures = client.futures.candles("NIFTY", "2025-01-01", "2025-01-31")
options = client.options.candles("BANKNIFTY", "2025-01-01", "2025-01-31",
                                 option_type="CE", strike=48000)
chain = client.options.chain("BANKNIFTY", date="2025-01-15")

# Crypto & Forex
btc = client.crypto.candles("BTCUSDT", "2025-01-01", "2025-01-02", interval="1h")
eurusd = client.forex.candles("EURUSD", "2025-01-01", "2025-01-02", interval="1h")

# Reference data
exchanges = client.market.exchanges(market="IN")
symbols = client.market.symbols(exchange="XNSE", query="RELIANCE")

# Fundamentals
fii_dii = client.fundamentals.fii_dii("2025-01-01", "2025-01-31")

# Account (your own key/credits only)
me = client.account.me()
keys = client.account.list_keys()

A process-wide default client is also available for scripts that only need one:

import sysstra_data as sd

sd.set_api_key("sk-...")
candles = sd.equities.eod("SBIN", "2025-01-01", "2025-06-30")

Error handling

Every non-2xx response raises a specific exception, all subclassing SysstraDataError:

Not yet implemented server-side

A few methods exist on the client for API symmetry but raise NotImplementedError until sysstra-data-services grows the matching route: options.greeks(), equities.announcements(), equities.fundamentals(), fundamentals.earnings_calendar(), fundamentals.earnings_transcript().

Development

pip install -e ".[dev]"
pytest tests/ --ignore=tests/test_uat_integration.py

tests/test_uat_integration.py boots a real sysstra-data-services instance in-process and needs that package importable plus a provisioned test API key.

License

MIT