sauda

NSE market data for Python. An async client for jugaad-rpc, the Rust gRPC server from the jugaad-rs monorepo. sauda only connects: you run the server (the wheel installs it as the jugaad-rpc command, or use the Docker image) and the client takes care of the connection.

pip install sauda

Start the server in its own terminal and leave it running. On macOS and Linux:

JUGAAD_RPC_ADDR=127.0.0.1:50051 jugaad-rpc

On Windows PowerShell:

$env:JUGAAD_RPC_ADDR = "127.0.0.1:50051"; jugaad-rpc

(Command Prompt and Docker are in the manual.)

Then connect from Python:

import asyncio
from sauda import Client

async def main():
    client = Client()
    await client.connect()                          # connects to 127.0.0.1:50051

    print((await client.stock_quote("SBIN"))["last_price"])
    rows = await client.stock_history("SBIN", "2026-01-01", "2026-01-31")
    async for q in client.watch_stock_quote("SBIN", interval=5):
        print(q["last_price"])
        break

    await client.disconnect()                       # the server keeps running

asyncio.run(main())

You decide when to connect and disconnect (in a notebook, connect in one cell and use the client in the cells after it). For a short script, async with Client() as c: does both for you. For a server at another address:

from sauda import Client, ConfigBuilder

config = ConfigBuilder().addr("127.0.0.1:50077").build()    # or ConfigBuilder().from_env()
client = Client()
await client.connect(config)

Results are plain dicts and lists of dicts, so pandas.DataFrame(rows) works directly. Client.stub is the raw generated async gRPC stub for anything not wrapped above.

Full reference, running the server (including Docker), configuration, error handling and troubleshooting: the manual. Upgrading from 0.1.x? 0.2.0 is async only and no longer starts a server for you, so see the upgrade notes.

Wheels: Windows x64, Linux x86_64 (glibc 2.28+), macOS Apple Silicon. Other platforms build from the source distribution, which needs Rust 1.88+. Python 3.9+.

Development

pip install -r requirements-gen.txt maturin
python generate.py           # generate src/sauda/_proto from the shared .proto
maturin develop --release    # build the server + install in the current venv
python smoke_test.py         # offline end-to-end check