Getting Started with INDstocks API¶

import requests
import os

# Get access token from environment variable
access_token = os.getenv('INDSTOCKS_TOKEN')

# API base URL
base_url = 'https://api.indstocks.com'

# Headers for authentication
headers = {
    'Authorization': access_token,
    'Content-Type': 'application/json'
}

# Fetch user profile
response = requests.get(f'{base_url}/user/profile', headers=headers)

if response.status_code == 200:
    profile = response.json()
    print(f"✅ Connected! Welcome, {profile['data']['first_name']} {profile['data']['last_name']}")
    print(f"User ID: {profile['data']['user_id']}")
    print(f"Email: {profile['data']['email']}")
else:
    print(f"❌ Error: {response.json()}")

import requests
import os

access_token = os.getenv('INDSTOCKS_TOKEN')
base_url = 'https://api.indstocks.com'
headers = {'Authorization': access_token}

# Fetch real-time quotes for Reliance (NSE_2885) and TCS (NSE_11536)
# Get scrip codes from the instruments API
params = {
    'scrip-codes': 'NSE_2885,NSE_11536'
}

response = requests.get(
    f'{base_url}/market/quotes/full',
    headers=headers,
    params=params
)

if response.status_code == 200:
    quotes = response.json()
    for symbol, data in quotes['data'].items():
        print(f"\n📈 {symbol}")
        print(f"   LTP: ₹{data['live_price']}")
        print(f"   Change: {data['day_change_percentage']}%")
        print(f"   Volume: {data['volume']:,}")
else:
    print(f"Error: {response.json()}")

import requests
import os

access_token = os.getenv('INDSTOCKS_TOKEN')
base_url = 'https://api.indstocks.com'
headers = {
    'Authorization': access_token,
    'Content-Type': 'application/json'
}

# Order parameters
order_data = {
    'txn_type': 'BUY',           # BUY or SELL
    'exchange': 'NSE',           # NSE or BSE
    'segment': 'EQUITY',         # EQUITY, FNO, etc.
    'security_id': '2885',       # Reliance security ID (get from instruments API)
    'qty': 1,                    # Quantity to buy
    'order_type': 'LIMIT',       # LIMIT, MARKET, STOP_LOSS, etc.
    'limit_price': 2450.00,      # Limit price
    'validity': 'DAY',           # DAY or IOC
    'product': 'CNC',            # CNC (delivery) or INTRADAY (intraday) or MARGIN (derivatives)
    'is_amo': False,             # After Market Order flag
    'algo_id': '99999'           # Required: Use 99999 for regular orders
}

# Place the order
response = requests.post(
    f'{base_url}/order',
    headers=headers,
    json=order_data
)

if response.status_code == 200:
    result = response.json()
    print(f"✅ Order placed successfully!")
    print(f"Order ID: {result['data']['order_id']}")
    print(f"Status: {result['data']['order_status']}")
else:
    error = response.json()
    print(f"❌ Order failed: {error.get('message', error)}")

import requests
import os

access_token = os.getenv('INDSTOCKS_TOKEN')
base_url = 'https://api.indstocks.com'
headers = {'Authorization': access_token}

# Get order book (all orders for the day)
response = requests.get(f'{base_url}/order-book', headers=headers)

if response.status_code == 200:
    orders = response.json()
    print("\n📋 Today's Orders:\n")
    for order in orders['data']:
        print(f"Order ID: {order['id']}")
        print(f"Symbol: {order['name']}")
        print(f"Status: {order['status']}")
        print(f"Qty: {order['requested_qty']} @ ₹{order['requested_price']}")
        print(f"Traded: {order['traded_qty']} @ ₹{order['traded_price']}")
        print("---")

import requests
import time
import logging
from typing import Dict, Optional

logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)

class INDstocksAPI:
    def __init__(self, access_token: str):
        self.base_url = 'https://api.indstocks.com'
        self.headers = {
            'Authorization': access_token,
            'Content-Type': 'application/json'
        }
        self.max_retries = 3

    def place_order(self, order_data: Dict) -> Optional[Dict]:
        """Place an order with retry logic and error handling"""
        for attempt in range(self.max_retries):
            try:
                response = requests.post(
                    f'{self.base_url}/order',
                    headers=self.headers,
                    json=order_data,
                    timeout=10
                )

                if response.status_code == 200:
                    result = response.json()
                    logger.info(f"Order placed: {result['data']['order_id']} - Status: {result['data']['order_status']}")
                    return result

                elif response.status_code == 429:  # Rate limit
                    wait_time = 2 ** attempt  # Exponential backoff
                    logger.warning(f"Rate limited. Retrying in {wait_time}s...")
                    time.sleep(wait_time)
                    continue

                else:
                    error = response.json()
                    logger.error(f"Order failed: {error['message']}")
                    return None

            except requests.exceptions.Timeout:
                logger.warning(f"Request timeout. Attempt {attempt + 1}/{self.max_retries}")
                time.sleep(2 ** attempt)

            except Exception as e:
                logger.error(f"Unexpected error: {str(e)}")
                return None

        logger.error("Max retries exceeded")
        return None

# Usage
api = INDstocksAPI(os.getenv('INDSTOCKS_TOKEN'))
order = {
    'txn_type': 'BUY',
    'exchange': 'NSE',
    'segment': 'EQUITY',
    'security_id': '2885',
    'qty': 1,
    'order_type': 'LIMIT',
    'limit_price': 2450.00,
    'validity': 'DAY',
    'product': 'CNC',
    'is_amo': False,
    'algo_id': '99999'
}
result = api.place_order(order)