sahiapi

The official Python SDK for the Sahi trading APIs.

Build trading and investing workflows in Python: place and manage orders, track holdings, positions and funds, pull quotes, candles and option chains, and receive live ticks and order updates over WebSocket.

Sahi © 2026. Released under the MIT License.

Documentation

• Python SDK documentation
• Sahi API reference
• Authentication and API keys
• Orders API reference

Features

• Orders: place, modify and cancel orders, and read the order book and the trades behind each order.
• Portfolio: holdings and open positions.
• Funds: available balance and margin in use.
• Market data: LTP and quotes for many instruments in one call, historical candles, option expiries and option chains.
• Live streams: SahiFeed streams LTP, quotes and market depth, plus order updates, and reconnects and resubscribes on its own.
• Typed errors: every API failure raises an exception carrying the HTTP status, error code, request id and a hint on how to fix it.

Installation

pip install sahiapi

Requires Python 3.9 or newer.

Quickstart

Create an API key in your Sahi account and approve it for the trading day, then connect:

import os
from sahiapi import SahiAPI

api = SahiAPI.from_credentials(
    key_id=os.environ["SAHI_KEY_ID"],
    secret=os.environ["SAHI_SECRET"],
)
print(api.get_profile())
print(api.get_funds())

Example: place a limit order

Prices are in paise, so ₹2,499.55 is 249955.

response = api.place_order(
    exchange_segment=SahiAPI.EXCHANGE_SEGMENT_NSE,
    symbol="RELIANCE",
    txn_type=SahiAPI.TXN_TYPE_BUY,
    qty=1,
    order_type=SahiAPI.ORDER_TYPE_LIMIT,
    product=SahiAPI.PRODUCT_DELIVERY,
    validity=SahiAPI.VALIDITY_DAY,
    price=249955,
)
order_id = response["order_ids"][0]
print(api.get_order_detail(order_id))

See the Python SDK documentation for streaming, market data and every other endpoint.