Introduction

This SDK wraps our REST-like APIs into easy-to-use Python methods, allowing you to focus on building your trading applications without worrying about the underlying API implementation details.

With the Groww SDK, you can easily execute and modify orders in real time, manage your portfolio, access live market data, and more — all through a clean and intuitive Python interface.

Key Features

• Trade with Ease: Place, modify, and cancel orders across Equity & F&O.
• Real-time Market Data: Fetch live market prices, historical data, and order book depth.
• Secure Authentication: Use industry-standard OAuth 2.0 for seamless and secure access.
• Comprehensive SDK: Get started quickly with our Python SDK.
• WebSockets for Streaming: Subscribe to real-time market feeds and order updates.

Getting started:

Step 1: Prerequisites

Trading on Groww using Groww APIs requires:

• A Groww account.
• Basic knowledge of Python and REST APIs.
• A development environment with Python 3.9+ installed.
• Having an active Trading API Subscription. You can purchase a subscription from this page.

Step 2: Install the Python SDK

You can install the Python SDK by running this command on your terminal/command prompt.

pip install growwapi

Step 3: Authentication

There are two ways you can interact with GrowwAPI:

1st Approach: Access Token

(Expires daily at 6:00 AM)

To generate an API access token:

• Log in to your Groww account.
• Click on the profile section at the Right-top of your screen.
• Click on the setting icon in the menu.
• In the navigation list, select ‘Trading APIs’
• Click on ‘Generate API keys’ and select ‘Access Token’
• You can create, revoke and manage all your tokens from this page.

You can use the generated ‘Access Token’ to log in via the Python SDK in the following way:

from growwapi import GrowwAPI
 
# Groww API Credentials (Replace with your actual credentials)
API_AUTH_TOKEN = "your_generated_access_token"
 
# Initialize Groww API
growwapi = GrowwAPI(API_AUTH_TOKEN)

2nd Approach: TOTP Flow

(Uses API Key and Secret — No Expiry)

Make sure you have the latest SDK version for this. You can upgrade your Python SDK by running this command on your terminal/command prompt.

pip install --upgrade growwapi

• Log in to your Groww account.
• Click on the profile section at the Right-top of your screen.
• Click on the setting icon in the menu.
• In the navigation list, select ‘Trading APIs’
• Click on ‘Generate API keys’ and select ‘API key & Secret’ You can create, revoke and manage all your tokens from this page.

To use the TOTP flow, you have to install the pyotp library. You can do that by running this command on your terminal/command prompt.

pip install pyotp

You can use the generated ‘API key & secret’ to log in via the Python SDK in the following way:

from growwapi import GrowwAPI 
import pyotp 
 
api_key = "YOUR_API_KEY" 
totp_gen = pyotp.TOTP('YOUR_API_SECRET') 
totp = totp_gen.now() 
 
access_token = GrowwAPI.get_access_token(api_key, totp) 
# Use access_token to initiate GrowwAPi
growwapi = GrowwAPI(access_token)

Step 4: Place your First Order

Use this sample code to place an order.

from growwapi import GrowwAPI
 
# Groww API Credentials (Replace with your actual credentials)
API_AUTH_TOKEN = "your_token"
 
# Initialize Groww API
groww = GrowwAPI(API_AUTH_TOKEN)
 
place_order_response = groww.place_order(
    trading_symbol="WIPRO",
    quantity=1, 
    validity=groww.VALIDITY_DAY,
    exchange=groww.EXCHANGE_NSE,
    segment=groww.SEGMENT_CASH,
    product=groww.PRODUCT_CNC,
    order_type=groww.ORDER_TYPE_LIMIT,
    transaction_type=groww.TRANSACTION_TYPE_BUY,
    price=250,               # Optional: Price of the stock (for Limit orders)
    trigger_price=245,       # Optional: Trigger price (if applicable)
    order_reference_id="Ab-654321234-1628190"  # Optional: User provided 8 to 20 length alphanumeric reference ID to track the order
)
print(place_order_response)

Rate Limits

The rate limits are applied at the type level, not on individual APIs. This means that all APIs grouped under a type (e.g., Orders, Live Data, Non Trading) share the same limit. If the limit for one API within a type is exhausted, all other APIs in that type will also be rate-limited until the limit window resets.

For Live feed, upto 1000 subscriptions are allowed at a time.