Changelog¶

Track all updates, new features, improvements, and bug fixes to the INDstocks Trading API.

[Unreleased]¶

✨ New Features¶

• Order Remarks: /order and /smart/order accept an optional remarks string — your own tag for an order (strategy name, signal id, anything you reconcile against). It comes back on GET /order, GET /order-book and GET /trade-book, so fills line up with your own system without a separate order-id map. Max 100 characters (longer is truncated, not rejected), fixed once placed, carried onto every leg of a smart order, and never sent to the exchange. A small reserved set is refused. See Order Remarks.
• Option Chain with Greeks: GET /market/option-chain returns the full strike ladder for an index or stock underlying in one call, with per-leg last price, OI and previous OI, volume, top-of-book bid/ask, implied volatility and Greeks (delta, gamma, theta, vega). Takes exchange, segment (INDEX/EQUITY), underlying-scrip, expiry (YYYY-MM-DD) and an optional strike_count (per side of ATM, default 10). See Option Chain.
• Contracts & Expiries: five endpoints for discovering derivative contracts without parsing the instruments master CSV. GET /market/instruments/search and GET /market/instruments/expiries cover currently trading contracts and their upcoming expiries; GET /market/instruments/expired/search, GET /market/instruments/expired/expiries and GET /market/instruments/expired/contracts do the same for expiries that have already passed, which is what makes historical options work. Filter by instrument_type, expiry, option_type and a strike_from/strike_to band. Only segment=DERIVATIVE is supported for now. Expired contracts are keyed by trading_symbol rather than security_id, because exchanges recycle instrument tokens after expiry. See Contracts & Expiries.

• Historical Data for Expired Contracts — coming soon; not yet enabled on production: GET /market/historical/expired/{interval} will return OHLCV candles for F&O contracts whose expiry has already passed, completing the price history of a contract from listing through to expiry. Contracts are addressed by trading-symbols — the trading_symbol from Contracts & Expiries — rather than scrip-codes, since exchanges reuse numeric instrument tokens once a contract has expired. Up to 50 symbols per call, from either derivatives segment — segment=NFO for NSE (the default) and segment=BFO for BSE. The candle contract, the supported intervals and the per-call maximum ranges all match Get Historical Data. See Get Expired Contract Candles.

• Trailing Stop Loss (TSL) for Smart Orders — not yet enabled on production; is_tsl and tsl_step_size are currently accepted and ignored: /smart/order will accept is_tsl and tsl_step_size, turning the stop-loss leg into a trailing stop-loss that steps along behind a favourable move and holds when the price turns. /order and /order-book expose is_tsl and tsl_step_size, and report the live trailed trigger in sl_trigger_price. Requires a stop-loss leg; not supported for TRIGGER orders; the step size is fixed once placed. See Trailing Stop Loss.

📚 Documentation¶

• Candle timestamps: Historical Data now specifies that ts is the candle's open time and that each candle covers [ts, ts + interval) — opening time inclusive, next candle's opening time exclusive — with a worked 5minute example and a note on deriving a closing time. It also names the intraday anchor: buckets align to the 09:15 IST session open rather than to wall-clock :00/:05 boundaries.
• Paging by date range: the per-call maximum range and how to page past it now have their own section, Paging by date range, covering both historical endpoints.

🐛 Bug Fixes¶

• Stop-loss and target legs on TRIGGER smart orders: a TRIGGER parent carrying a stop-loss leg (BUY) or a target leg (SELL) was rejected with a nonsensical bound — for example SL Trigger Price should be less than -0.05. The legs were being checked against limit_price. A TRIGGER order enters at its trigger_limit_price and does not use limit_price, so for any request following the documented contract the bound was computed from zero and collapsed to one tick either side of it. Both legs are now checked against the order's entry price: trigger_limit_price, or trigger_price when that is omitted. The same correction closes the opposite case, where a leg on the wrong side of the entry — a BUY target below it, or a SELL stop-loss below it — was accepted silently. See Smart Orders.

[v1.3.0] - 2024-12-15¶

✨ New Features¶

• Option Greeks API: Calculate real-time Greeks (Delta, Gamma, Theta, Vega, Rho) for options
• Multi-leg Order Support: Place complex multi-leg strategies in a single API call
• Enhanced Historical Data: Extended historical data availability to 15 years
• Instrument Search API: New endpoint to search instruments by name/symbol

🚀 Improvements¶

• Faster order execution: Optimized order routing for improved performance
• WebSocket reliability: Improved connection stability with automatic reconnection
• Better error messages: More descriptive error responses with actionable solutions
• Rate limit headers: Added X-RateLimit-* headers to all responses

🐛 Bug Fixes¶

• Fixed issue where some F&O instruments showed incorrect lot sizes
• Resolved WebSocket disconnection issues during high market volatility
• Fixed timezone handling in historical data API
• Corrected margin calculation for spread orders

📚 Documentation¶

• Added comprehensive FAQ page
• New Getting Started tutorial
• Enhanced WebSocket guide with reconnection examples

[v1.2.5] - 2024-10-28¶

🚀 Improvements¶

• Faster market quotes: Reduced latency for /market/quotes endpoint by 40%
• Batch order support: Place up to 50 orders in a single API call
• Enhanced portfolio API: Added real-time P&L calculations
• Better GTT order handling: Improved trigger accuracy for Smart Orders

🐛 Bug Fixes¶

• Fixed race condition in order modification during high-frequency trading
• Resolved issue with incorrect available margin calculation
• Fixed WebSocket subscription limits not being enforced correctly

📚 Documentation¶

• Added Python SDK examples to all major endpoints
• Updated Order Management guide with batch order examples
• Improved Error Handling documentation

[v1.2.0] - 2024-09-10¶

✨ New Features¶

• Smart Orders (GTT): Launch of advanced Good Till Triggered orders
• OCO Orders: One-Cancels-Other order type for automated risk management
• Option Chain API: Get complete option chain data with Greeks
• Funds API Enhancement: Added detailed fund breakdown and utilization

🚀 Improvements¶

• Infrastructure upgrades: Improved reliability and performance
• Enhanced security: Added rate limiting and DDoS protection
• Better WebSocket performance: Improved message delivery
• Improved margin API: Real-time margin requirements for complex orders

🐛 Bug Fixes¶

• Fixed issue with historical data gaps during market holidays
• Resolved incorrect LTP for illiquid securities
• Fixed order book pagination issues

[v1.1.5] - 2024-07-22¶

🚀 Improvements¶

• Order execution speed: Improved performance
• Historical data: Added 5-minute candle intervals
• Position tracking: Enhanced positions API with average price calculations
• Better error codes: More specific error types for easier debugging

🐛 Bug Fixes¶

• Fixed timezone issues in historical data responses
• Resolved WebSocket authentication errors on reconnection
• Fixed incorrect holdings valuation for bonus shares

📚 Documentation¶

• Added JavaScript SDK examples
• Improved API Conventions documentation
• New examples for Portfolio API

[v1.1.0] - 2024-06-05¶

✨ New Features¶

• WebSocket API: Real-time market data streaming with <5ms latency
• Order Updates Stream: Real-time order and trade confirmations via WebSocket
• Historical Data API: Access 10+ years of OHLCV data
• Margin Calculator: Pre-calculate margin requirements before placing orders

🚀 Improvements¶

• API performance: 50% reduction in average response time
• Better authentication: More detailed token validation errors
• Enhanced holdings API: Added average price and P&L fields
• Improved instruments data: Daily updates with corporate actions

🐛 Bug Fixes¶

• Fixed order rejection for AMO (After Market Orders)
• Resolved issues with special characters in instrument names
• Fixed incorrect order status in edge cases

[v1.0.8] - 2024-04-15¶

🚀 Improvements¶

• Order placement: Reduced order execution time by 25%
• Market data: Added market depth (Level 2) data
• Portfolio API: Enhanced with realized P&L tracking
• Better logging: Improved request tracking for debugging

🐛 Bug Fixes¶

• Fixed issue with duplicate order IDs in rare cases
• Resolved rate limiting false positives
• Fixed incorrect exchange segment mapping for some instruments

📚 Documentation¶

• Added comprehensive Margin Calculation guide
• New examples for basket orders
• Improved Market Quotes documentation

[v1.0.5] - 2024-02-20¶

✨ New Features¶

• Positions API: Track open derivative positions with real-time P&L
• Trade History: New endpoint to retrieve detailed trade confirmations
• Instrument Master: Daily CSV file with all tradeable instruments

🚀 Improvements¶

• Better error handling: More descriptive error messages
• Enhanced order types: Added support for bracket orders
• Improved performance: Faster response times across all endpoints
• Security enhancements: Additional validation for order parameters

🐛 Bug Fixes¶

• Fixed issues with limit orders at circuit limits
• Resolved timeout errors during market open
• Fixed incorrect quantity validation for F&O orders

[v1.0.0] - 2024-01-10¶

🎉 Initial Release¶

The INDstocks Trading API v1 is now live!

Core Features¶

• Order Management: Place, modify, and cancel orders across all segments
• Market Data: Real-time quotes, LTP, and market depth
• Portfolio Management: Holdings, positions, and funds APIs
• Authentication: Simple token-based authentication
• User Profile: Access account details and preferences

Supported Segments¶

• Equity (NSE, BSE)
• Derivatives (Futures & Options)
• Currency derivatives
• Commodity derivatives

Technical Specs¶

• Rate limits: 10 orders/sec, 100 API calls/sec
• API access: Free

Version History Summary¶

Upcoming Features¶

We're constantly improving the INDstocks API. Here's what's coming next:

🔜 Q1 2025¶

• Algo Trading Framework: Built-in strategy templates and backtesting
• Advanced Analytics: Pre-built indicators and signals
• Mobile SDKs: Native iOS and Android SDKs
• GraphQL API: Alternative to REST for complex queries

🔮 Q2 2025¶

• Webhooks: Push notifications for order updates and triggers
• Enhanced Greeks: Historical Greeks data and implied volatility
• Social Trading: Copy trading and strategy sharing

💡 Roadmap¶

Want to influence our roadmap? Share your feature requests at api-feedback@indstocks.com

Deprecation Policy¶

We're committed to backwards compatibility:

• Deprecation notice: 12 months advance warning
• Support period: 24 months for deprecated features
• Migration guides: Provided for all breaking changes
• API versioning: Semantic versioning (MAJOR.MINOR.PATCH)

Currently Deprecated¶

No features are currently deprecated.

Migration Guides¶

Migrating from v1.2.x to v1.3.x¶

No breaking changes. All v1.2.x code is compatible with v1.3.x.

New optional fields: - Added greeks field to option quotes (opt-in via query parameter) - Added strategy_type field for multi-leg orders

Migrating from v1.1.x to v1.2.x¶

No breaking changes. All v1.1.x code is compatible with v1.2.x.

Enhanced features: - GTT orders now support multiple triggers (backwards compatible) - Historical data now includes adjusted prices (new field, old field unchanged)

Release Notes Format¶

Each release includes:

• ✨ New Features: Brand new capabilities
• 🚀 Improvements: Enhancements to existing features
• 🐛 Bug Fixes: Resolved issues and bugs
• 📚 Documentation: Documentation updates and additions
• ⚠️ Breaking Changes: Incompatible changes (rare, with migration guide)
• 🔒 Security: Security-related improvements

Stay Connected¶

• 📧 Email: api-updates@indstocks.com
• 📊 Status Page: status.indstocks.com
• 🐦 Twitter: @INDstocksApp
• 💬 Community: Developer community coming soon

Need Help?¶

Questions about a specific version or feature?

• Check our FAQ
• Read the API Overview
• Contact support at instockssupport@indmoney.com