INDstocks API Suite - Complete Overview¶

API Summary¶

The INDstocks API Suite v1 is a comprehensive RESTful API designed for financial trading applications. This API suite provides real-time market data, order management, and portfolio tracking capabilities with robust error handling and extensive market coverage.

Pricing & Cost Structure¶

• API Access: Free - No subscription fees or API charges
• Brokerage: ₹5 per order - Flat rate regardless of order size
• No Hidden Costs: Transparent pricing with no additional charges

Core Features¶

🚀 Performance¶

• Sub-20ms latency for order execution
• WebSocket streams for real-time market data
• Optimized JSON responses with minimal payload sizes

🔒 Security¶

• Token-based authentication
• Rate limiting and abuse prevention
• Encryption in transit

📊 Market Coverage¶

• Multi-exchange support (NSE and more)
• All asset classes: Equity, Derivatives, Options, Futures
• Real-time market quotes
• Historical data with extensive time series

🎯 Trading Features¶

• Smart Orders (GTT) with advanced multi-leg trading strategies
• Stop-loss and target automation with intelligent routing
• Portfolio management with real-time P&L tracking
• Advanced margin calculations with dynamic risk assessment
• Multi-exchange support (NSE, BSE) with unified interface
• All asset classes: Equity, Derivatives, Options, Futures

Complete API Endpoint Catalog¶

1. User Management & Profile¶

Note: Authentication is handled via access tokens obtained from the indstocks.com dashboard.

2. Market Data APIs¶

3. Order Management¶

4. Smart Orders¶

5. Portfolio & Risk Management¶

6. WebSocket Streaming¶

7. Utility & System APIs¶

📚 Complete Documentation Guide¶

For detailed implementation guides, refer to these comprehensive documentation pages:

Getting Started¶

• Introduction - API overview and getting started guide
• API Conventions - Standards, formats, and best practices
• Users Guide - Authentication and user management

Market Data & Instruments¶

• Instruments Data - Market instruments and symbols
• Market Quotes - Real-time market data and quotes
• Historical Data - Historical OHLCV data access

Trading & Orders¶

• Orders - Standard order placement and management
• Smart Orders (GTT) - Advanced multi-leg trading strategies

Portfolio & Risk¶

• Portfolio & Holdings - Portfolio management and funds
• Margin Calculation - Risk management and margin requirements

Real-time & Utilities¶

• WebSockets - Real-time data streaming
• Utility APIs - Helper functions and system utilities
• Error Handling - Comprehensive error codes and handling

Developer Resources¶

• LLM Metadata - AI/LLM optimized documentation

Technical Specifications¶

How to Get Your Access Token: 1. Login to indstocks.com 2. Navigate to API section → "Get Started with INDstocks APIs" 3. Copy your access token for API requests

Error Handling Excellence¶

• HTTP Status Codes: Standard compliance
• Error Response Format: Structured JSON
• Error Categories: 400-499 (Client), 500-599 (Server)

Integration Examples¶

Quick Start (Python)¶

import requests

# Get your access token from indstocks.com dashboard
access_token = "YOUR_ACCESS_TOKEN_FROM_DASHBOARD"

# Place Order
order_response = requests.post('https://api.indstocks.com/order',
                              headers={
                                  'Authorization': access_token,
                                  'Content-Type': 'application/json'
                              },
                              json={
                                  'txn_type': 'BUY',
                                  'exchange': 'NSE',
                                  'segment': 'EQUITY',
                                  'security_id': '12345',
                                  'qty': 100,
                                  'order_type': 'LIMIT',
                                  'limit_price': 150.50,
                                  'validity': 'DAY',
                                  'product': 'CNC',
                                  'is_amo': False,
                                  'algo_id': '99999'
                              })

WebSocket Integration¶

const ws = new WebSocket('wss://api.indstocks.com/ws');
ws.on('message', (data) => {
    const marketData = JSON.parse(data);
    console.log('Live Quote:', marketData);
});

Performance Metrics & Benchmarks¶

Latency Performance¶

• Order Execution: Fast response time for order placement
• WebSocket Data: Real-time market feeds
• API Response: Optimized for standard API calls

Reliability Metrics¶

• Error Rate: Low system error rate
• Throughput: High concurrent request support

Cost Efficiency¶

• API Access: Free (no subscription charges)
• Brokerage: Flat ₹5 per order (regardless of size)
• Data Feeds: Real-time data included at no extra cost
• Historical Data: 10+ years of historical data available

Key Benefits¶

1. Developer Experience¶

• Comprehensive documentation with interactive examples
• SDKs available in Python, JavaScript, Java
• 24/7 developer support

2. Reliability & Performance¶

• Financial-grade infrastructure
• Optimized for low-latency access
• Auto-scaling to handle peak trading volumes

3. Feature Completeness¶

• All order types supported (Market, Limit, Stop-Loss, GTT)
• Multi-asset support (Equity, F&O, Commodities)
• Advanced analytics with portfolio insights
• Compliance ready

Conclusion¶

The INDstocks API Suite provides enterprise-grade reliability and comprehensive functionality for financial trading applications. The API is designed for trading algorithms, fintech applications, and systems requiring high-quality API integration.

Contact: [email protected] | Documentation: https://api-docs.indstocks.com