Skip to content

Tiny-Trader/connect

tt-connect

CI Docs PyPI version Python License

tt-connect is a unified Python broker API for Indian markets. It gives one canonical interface for auth, instruments, orders, portfolio, reports, and live market streaming across brokers.

Who This Is For

  • Trading system developers who want broker portability
  • Teams building execution, monitoring, or portfolio services
  • Contributors extending broker support and reliability

Quick Start

pip install tt-connect
from tt_connect import TTConnect
from tt_connect.instruments import Equity
from tt_connect.enums import Exchange, Side, ProductType, OrderType

with TTConnect("zerodha", {"api_key": "...", "access_token": "..."}) as broker:
    order_id = broker.place_order(
        instrument=Equity(exchange=Exchange.NSE, symbol="RELIANCE"),
        side=Side.BUY,
        qty=1,
        order_type=OrderType.MARKET,
        product=ProductType.CNC,
    )
    print(order_id)

Documentation

Guide Description
Live Docs Site Full user docs on GitHub Pages
Quick Start Get installed and place your first order in 5 minutes
Examples Complete working code for Zerodha and AngelOne
Contributor Guide Local setup, testing, implementation workflow
Architecture System design and internals

Broker Capability Snapshot

Capability Zerodha AngelOne
Auth modes Manual Manual + Auto
Profile/Funds/Holdings/Positions Yes Yes
Orders (place/modify/cancel/list) Yes Yes
Trades Yes Yes
Instrument fetch + resolve Yes Yes
Streaming (WebSocket) Yes Yes
GTT orders Yes Yes
Margin calculator API Not supported Not supported

Development Commands

make lint
make typecheck
make test-fast
make coverage

Legal and Risk Notices

About

Unified Python broker API for Indian markets: auth, orders, portfolio, instruments, and websocket streaming.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages