Introduction

Overview

The Shoonya API, powered by Finvasia, gives developers and traders a secure, reliable, and high-performance interface to automate trades, access live market data, and manage portfolios programmatically.

Manual trading doesn't scale, and it doesn't fail gracefully. Automate the workflow instead: fewer operational errors, consistent execution, and a system you can actually test. Noren OMS was built for the scale of the Indian broking market and is under continuous testing for stability, throughput, and latency.

Who this is for

• Retail algo traders — running a strategy against your own account. Start with Quick Start and the Python SDK.
• Platform & vendor integrators — onboarding multiple clients under one app. You'll spend most of your time in OAuth for vendors and the rate-limit conventions under Getting Started.
• Fintechs & quant desks — need market data at low latency and at scale. Go straight to Streaming for tick and order-update feeds.

Quick look

Before you write any code

• Read Rate Limits first. It'll save you a rewrite later.
• Use the WebSocket feed for live prices. Don't poll Market Quotes in a loop — it's slower for you and it costs everyone else headroom.
• Treat your session token like a password: store it securely, never commit it, rotate it on renewal.

How this documentation is organized

• Getting Started — environment setup, first request, error and rate-limit conventions.
• Authentication — OAuth 2.0 login flow, vendor onboarding, token renewal.
• Trading APIs — order placement, modification, book and position endpoints.
• Market Data APIs — quotes, depth, historical candles, option chain.
• Streaming — WebSocket feeds for ticks and order updates.
• SDK Reference — official Python SDK and code samples.
• Annexure — every code and enum used across the API in one place.

Best practices

• Read Rate Limits before writing any polling loop.
• Use the WebSocket feed for live prices — don't poll Market Quotes in a tight loop.
• Store your session token securely and never commit it to source control.

Next

This page is the front door. Everything after it assumes you've completed Quick Start — that's where to go next.