Kite Connect JavaScript/TypeScript Client

https://github.com/zerodha/kiteconnectjs
Admin
Official TypeScript/JavaScript client library for Kite Connect APIs, providing REST and WebSocket...
Tokens:32,023
Snippets:384
Trust Score:8
License:MIT
Update:1 month ago
Show doc for...
Tokens:
Raw
### Install KiteConnect package

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/README.md

Use npm to install the library in your project.

```bash
npm install kiteconnect
```

--------------------------------

### Get Orders

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves the list of all orders.

```http
GET /orders
Authorization: token {api_key}:{access_token}
```

--------------------------------

### Generate Documentation

Source: https://github.com/zerodha/kiteconnectjs/blob/master/README.md

Install TypeDoc as a development dependency and use it to generate project documentation in the docs directory.

```bash
$ npm install typedoc --save-dev
$ npx typedoc --out ./docs
```

--------------------------------

### Configure KiteConnect Instances

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/configuration.md

Examples of initializing the KiteConnect client for different use cases, including pre-login, persistent sessions, and debugging.

```typescript
const kc = new KiteConnect({
  api_key: 'your_api_key'
});
```

```typescript
const kc = new KiteConnect({
  api_key: 'your_api_key',
  access_token: 'saved_access_token_from_database'
});
```

```typescript
const kc = new KiteConnect({
  api_key: 'your_api_key',
  access_token: 'your_access_token',
  debug: true,
  timeout: 15000  // Longer timeout for debugging
});
```

```typescript
const kc = new KiteConnect({
  api_key: 'your_api_key',
  access_token: 'your_access_token',
  debug: false,
  timeout: 5000   // Shorter timeout for fast response
});
```

--------------------------------

### Initialize and Connect KiteTicker

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/api-reference/KiteTicker.md

Demonstrates the full lifecycle of a KiteTicker instance, including configuration, event listener setup, subscription management, and graceful shutdown.

```typescript
import { KiteTicker } from 'kiteconnect';

const apiKey = 'your_api_key';
const accessToken = 'your_access_token';

const ticker = new KiteTicker({
  api_key: apiKey,
  access_token: accessToken,
  reconnect: true,
  max_retry: 20,
  max_delay: 60
});

// Setup event handlers
ticker.on('connect', () => {
  console.log('Connected to stream');
  const tokens = [738561, 256265];
  ticker.subscribe(tokens);
  ticker.setMode(ticker.modeFull, tokens);
});

ticker.on('ticks', (ticks) => {
  ticks.forEach(tick => {
    console.log(`Token: ${tick.instrument_token}, Price: ${tick.last_price}`);
  });
});

ticker.on('error', (error) => {
  console.error('Error:', error);
});

ticker.on('disconnect', (error) => {
  console.log('Disconnected:', error);
});

ticker.on('reconnect', (count, interval) => {
  console.log(`Reconnecting... (attempt ${count}, waiting ${interval}s)`);
});

ticker.on('noreconnect', () => {
  console.log('Could not reconnect, giving up');
  process.exit(1);
});

ticker.on('order_update', (order) => {
  console.log('Order update:', order);
});

// Connect to stream
ticker.connect();

// Graceful shutdown
process.on('SIGINT', () => {
  console.log('Shutting down...');
  ticker.disconnect();
  process.exit(0);
});
```

--------------------------------

### Full WebSocket Auto Reconnect Example

Source: https://github.com/zerodha/kiteconnectjs/blob/master/README.md

Demonstrates setting up a KiteTicker with auto-reconnection, handling ticks, and managing connection events like 'connect', 'noreconnect', and 'reconnect'.

```typescript
import { KiteTicker } from "kiteconnect";

const apiKey = "your_api_key";
const accessToken = "generated_access_token";
const ticker = new KiteTicker({
  api_key: "api_key",
  access_token: "access_token",
});
ticker.autoReconnect(true, 10, 5);
ticker.connect();
ticker.on("ticks", onTicks);
ticker.on("connect", subscribe);
ticker.on("noreconnect", () => {
  console.log("noreconnect");
});
ticker.on("reconnect", (reconnect_count: any, reconnect_interval: any) => {
  console.log(
    "Reconnecting: attempt - ",
    reconnect_count,
    " interval - ",
    reconnect_interval
  );
});

function onTicks(ticks: any[]) {
  console.log("Ticks", ticks);
}

function subscribe() {
  const items = [738561];
  ticker.subscribe(items);
  ticker.setMode(ticker.modeFull, items);
}
```

--------------------------------

### GeneralException Example

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/errors.md

Represents unclassified or internal server errors.

```typescript
{
  error_type: 'GeneralException',
  message: 'Internal server error',
  data: null
}
```

--------------------------------

### Verify Node.js version

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/configuration.md

Check the currently installed Node.js version via command line.

```bash
node --version  # Should output v18.0.0 or higher
```

--------------------------------

### GET /mf/instruments

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves the list of mutual fund instruments.

```APIDOC
## GET /mf/instruments

### Description
Fetches the master list of mutual fund instruments available for trading.

### Method
GET

### Endpoint
/mf/instruments

### Response
#### Success Response (200)
- **data** (array) - Parsed array of mutual fund instrument objects.

### Status Codes
- 200: Success
- 401: Unauthorized
```

--------------------------------

### GET /portfolio/positions

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves the user's current positions.

```APIDOC
## GET /portfolio/positions

### Description
Retrieves the user's current positions.

### Method
GET

### Endpoint
/portfolio/positions

### Response
#### Success Response (200)
- **data** (object) - Contains day and net positions
```

--------------------------------

### GET /instruments

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves the list of all instruments or instruments for a specific exchange.

```APIDOC
## GET /instruments

### Description
Retrieves the list of all instruments or instruments for a specific exchange.

### Method
GET

### Endpoint
/instruments or /instruments/{exchange}

### Parameters
#### Path Parameters
- **exchange** (string) - Optional - The exchange to filter instruments by.

### Response
#### Success Response (200)
- **data** (array) - List of instruments parsed to an array of objects.

### Status Codes
- 200: Success
- 401: Unauthorized
```

--------------------------------

### GET /portfolio/holdings/auctions

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves auction instruments for holdings.

```APIDOC
## GET /portfolio/holdings/auctions

### Description
Retrieves auction instruments for holdings.

### Method
GET

### Endpoint
/portfolio/holdings/auctions

### Response
#### Success Response (200)
- **data** (array) - List of auction instrument objects
```

--------------------------------

### Get Positions Request

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves current day and net positions.

```http
GET /portfolio/positions
Authorization: token {api_key}:{access_token}
```

--------------------------------

### Get Quote

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Fetch real-time market quotes for specified instruments.

```http
GET /quote?i=NSE:INFY&i=NSE:TCS
Authorization: token {api_key}:{access_token}
```

--------------------------------

### GET /quote

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves market quotes for specified instruments.

```APIDOC
## GET /quote

### Description
Retrieves market quotes for specified instruments.

### Method
GET

### Endpoint
/quote

### Parameters
#### Query Parameters
- **i** (string) - Required - Instruments in 'EXCHANGE:TRADINGSYMBOL' format, multiple values supported.

### Response
#### Success Response (200)
- **data** (object) - Map of instrument keys to quote details.

### Status Codes
- 200: Success
- 400: Invalid instruments
- 401: Unauthorized
```

--------------------------------

### GET /trades

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves the list of trades executed.

```APIDOC
## GET /trades

### Description
Retrieves the list of trades executed.

### Method
GET

### Endpoint
/trades

### Response
#### Success Response (200)
- **data** (array) - List of trade objects containing trade_id, order_id, quantity, price, etc.
```

--------------------------------

### GET /user/profile

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves the user's profile information.

```APIDOC
## GET /user/profile

### Description
Retrieves the user's profile information.

### Method
GET

### Endpoint
/user/profile

### Response
#### Success Response (200)
- **data** (object) - User profile details including user_id, email, phone, name, broker, and avatar_url.
```

--------------------------------

### Get Instruments

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieve the list of instruments for all exchanges or a specific exchange.

```http
GET /instruments
Authorization: token {api_key}:{access_token}

// Or:
GET /instruments/{exchange}
```

--------------------------------

### GET /portfolio/holdings

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves the user's portfolio holdings.

```APIDOC
## GET /portfolio/holdings

### Description
Retrieves the user's portfolio holdings.

### Method
GET

### Endpoint
/portfolio/holdings

### Response
#### Success Response (200)
- **data** (array) - List of holding objects
```

--------------------------------

### Get Holdings Request

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves the current portfolio holdings.

```http
GET /portfolio/holdings
Authorization: token {api_key}:{access_token}
```

--------------------------------

### Get User Profile

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves the profile information for the authenticated user.

```http
GET /user/profile
Authorization: token {api_key}:{access_token}
```

--------------------------------

### Get Mutual Fund Instruments

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Fetch the list of available mutual fund instruments as a CSV response.

```http
GET /mf/instruments
Authorization: token {api_key}:{access_token}
```

--------------------------------

### Get Login URL

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/api-reference/KiteConnect.md

Retrieve the URL required to initiate the user login flow.

```typescript
const loginUrl = kc.getLoginURL();
// https://kite.zerodha.com/connect/login?api_key=your_api_key&v=3
```

--------------------------------

### Get Auction Instruments Request

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves auction instruments for holdings.

```http
GET /portfolio/holdings/auctions
Authorization: token {api_key}:{access_token}
```

--------------------------------

### Get LTP

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Fetch the Last Traded Price for specified instruments.

```http
GET /quote/ltp?i=NSE:INFY&i=NSE:TCS
Authorization: token {api_key}:{access_token}
```

--------------------------------

### Get User Margins

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves margin details for all segments or a specific segment.

```http
GET /user/margins
Authorization: token {api_key}:{access_token}

// Or for specific segment:
GET /user/margins/{segment}
```

--------------------------------

### GET /instruments/historical/{instrument_token}/{interval}

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves historical candle data for a specific instrument.

```APIDOC
## GET /instruments/historical/{instrument_token}/{interval}

### Description
Retrieves historical candle data for a specific instrument.

### Method
GET

### Endpoint
/instruments/historical/{instrument_token}/{interval}

### Parameters
#### Path Parameters
- **instrument_token** (number) - Required - Instrument token ID.
- **interval** (string) - Required - Time interval (minute, 3minute, 5minute, 15minute, 30minute, 60minute, day, week, month).

#### Query Parameters
- **from** (string) - Required - Start date 'YYYY-MM-DD HH:MM:SS'.
- **to** (string) - Required - End date 'YYYY-MM-DD HH:MM:SS'.
- **continuous** (boolean) - Optional - Continuous contract data.
- **oi** (boolean) - Optional - Open interest data.

### Response
#### Success Response (200)
- **data** (object) - Contains candles array with timestamp, open, high, low, close, volume, and optional oi.

### Status Codes
- 200: Success
- 400: Invalid parameters
- 401: Unauthorized
```

--------------------------------

### GET /mf/orders

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves a list of all mutual fund orders or details for a specific order.

```APIDOC
## GET /mf/orders

### Description
Retrieves all mutual fund orders or a specific order if an order_id is provided.

### Method
GET

### Endpoint
/mf/orders or /mf/orders/{order_id}

### Parameters
#### Path Parameters
- **order_id** (string) - Optional - The unique identifier for a specific order.

### Response
#### Success Response (200)
- **data** (array/object) - List of orders or a single order object containing order_id and status.

### Status Codes
- 200: Success
- 401: Unauthorized
```

--------------------------------

### View project file structure

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/README.md

Overview of the repository organization and documentation files.

```text
├── api-reference/
│   ├── KiteConnect.md      — Main REST API class reference
│   └── KiteTicker.md       — WebSocket client reference
├── types.md                — All types, interfaces, enums
├── endpoints.md            — HTTP/WebSocket endpoints map
├── errors.md               — Error types and handling
├── configuration.md        — Configuration options
└── README.md              — This file
```

--------------------------------

### Environment-Specific Client Configuration

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/INDEX.md

Demonstrates initializing the KiteConnect client with different settings for production and development environments.

```typescript
// Production: optimized
new KiteConnect({ timeout: 5000, debug: false })

// Development: verbose
new KiteConnect({ timeout: 15000, debug: true })
```

--------------------------------

### GET /gtt/triggers

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves a list of all active GTT triggers.

```APIDOC
## GET /gtt/triggers

### Description
Retrieves a list of all active GTT triggers for the user.

### Method
GET

### Endpoint
/gtt/triggers

### Response
#### Success Response (200)
- **data** (array) - List of trigger objects containing trigger_id and status.

#### Response Example
{
  "data": [{"trigger_id": 123, "status": "active"}]
}
```

--------------------------------

### connect()

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/api-reference/KiteTicker.md

Establishes a WebSocket connection to the Kite streaming service.

```APIDOC
## connect()

### Description
Establishes a WebSocket connection to the Kite streaming service. If already connected or connecting, this method does nothing.

### Returns
- **void**

### Emits Events
- **'connect'** on successful connection
```

--------------------------------

### Initialize KiteConnect and Generate Session

Source: https://github.com/zerodha/kiteconnectjs/blob/master/README.md

This snippet demonstrates how to initialize the KiteConnect client, generate a session using an API key, secret, and request token, and then fetch the user profile. Ensure you have your API key, secret, and a valid request token.

```typescript
import { KiteConnect } from "kiteconnect";

const apiKey = "your_api_key";
const apiSecret = "your_api_secret";
const requestToken = "your_request_token";

const kc = new KiteConnect({ api_key: apiKey });

async function init() {
  try {
    await generateSession();
    await getProfile();
  } catch (err) {
    console.error(err);
  }
}

async function generateSession() {
  try {
    const response = await kc.generateSession(requestToken, apiSecret);
    kc.setAccessToken(response.access_token);
    console.log("Session generated:", response);
  } catch (err) {
    console.error("Error generating session:", err);
  }
}

async function getProfile() {
  try {
    const profile = await kc.getProfile();
    console.log("Profile:", profile);
  } catch (err) {
    console.error("Error getting profile:", err);
  }
}
// Initialize the API calls
init();

```

--------------------------------

### Initialize KiteTicker for WebSocket Communication

Source: https://github.com/zerodha/kiteconnectjs/blob/master/README.md

This snippet shows how to set up and connect a KiteTicker instance for real-time market data using WebSockets. It includes event handlers for ticks, connection status, errors, and order updates. You need a valid API key and an access token.

```typescript
import { KiteTicker } from "kiteconnect";

const apiKey = "your_api_key";
const accessToken = "generated_access_token";

const ticker = new KiteTicker({
  api_key: apiKey,
  access_token: accessToken,
});

ticker.connect();
ticker.on("ticks", onTicks);
ticker.on("connect", subscribe);
ticker.on("disconnect", onDisconnect);
ticker.on("error", onError);
ticker.on("close", onClose);
ticker.on("order_update", onTrade);
ticker.on("message", onMessage);

function onTicks(ticks: any[]): void {
  console.log("Ticks", ticks);
}

function subscribe(): void {
  const tokens = [738561, 256265];
  ticker.subscribe(tokens);
  ticker.setMode(ticker.modeFull, tokens);
}

function onDisconnect(error: Error): void {
  console.log("Closed connection on disconnect", error);
}

function onError(error: Error): void {
  console.log("Closed connection on error", error);
}

function onClose(reason: string): void {
  console.log("Closed connection on close", reason);
}

function onTrade(order: any): void {
  console.log("Order update", order);
}

function onMessage(binaryData: ArrayBuffer): void {
  console.log("Binary message received", binaryData);
  // Process raw WebSocket binary data if needed
}

```

--------------------------------

### Initialize KiteConnect Client

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/api-reference/KiteConnect.md

Instantiate the KiteConnect client with your API credentials and configuration options.

```typescript
import { KiteConnect } from 'kiteconnect';

const kc = new KiteConnect({
  api_key: 'your_api_key',
  access_token: 'your_access_token',
  debug: false,
  timeout: 7000
});
```

--------------------------------

### Get Trades Request

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves the list of executed trades.

```http
GET /trades
Authorization: token {api_key}:{access_token}
```

--------------------------------

### GET /orders/{order_id}

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves the history of a specific order.

```APIDOC
## GET /orders/{order_id}

### Description
Retrieves the history of a specific order.

### Method
GET

### Endpoint
/orders/{order_id}

### Response
#### Success Response (200)
- **data** (array) - List of order history events.
```

--------------------------------

### Run Unit Tests

Source: https://github.com/zerodha/kiteconnectjs/blob/master/README.md

Execute the project's unit tests using the npm test script.

```bash
npm run test
```

--------------------------------

### Initialize KiteConnect with Environment Variables

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/configuration.md

Use environment variables to manage sensitive credentials and configuration settings securely.

```typescript
// Load from environment variables
const config = {
  api_key: process.env.KITE_API_KEY!,
  access_token: process.env.KITE_ACCESS_TOKEN,
  debug: process.env.NODE_ENV === 'development',
  timeout: parseInt(process.env.KITE_TIMEOUT || '7000')
};

const kc = new KiteConnect(config);
```

--------------------------------

### POST /orders/{variety}

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/INDEX.md

Places a new order in the system.

```APIDOC
## POST /orders/{variety}

### Description
Places a new order in the system. This endpoint requires the order variety as a path parameter.

### Method
POST

### Endpoint
/orders/{variety}

### Parameters
#### Path Parameters
- **variety** (string) - Required - The variety of the order (e.g., regular, amo, iceberg, bracket, cover).

### Response
#### Success Response (200)
- **data** (object) - The order response object containing the order_id and optional children.
```

--------------------------------

### Get GTT Triggers

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieve a list of all active GTT triggers.

```http
GET /gtt/triggers
Authorization: token {api_key}:{access_token}
```

--------------------------------

### Configure Minimal KiteTicker Instance

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/configuration.md

Initializes the ticker with only the mandatory API key and access token.

```typescript
const ticker = new KiteTicker({
  api_key: 'your_api_key',
  access_token: 'your_access_token'
});
```

--------------------------------

### GET /mf/holdings

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves the user's mutual fund holdings.

```APIDOC
## GET /mf/holdings

### Description
Fetches the list of mutual fund holdings currently held by the user.

### Method
GET

### Endpoint
/mf/holdings

### Response
#### Success Response (200)
- **data** (array) - List of holding objects including tradingsymbol, quantity, and nav.

### Status Codes
- 200: Success
- 401: Unauthorized
```

--------------------------------

### KiteConnect Constructor

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/api-reference/KiteConnect.md

Initializes a new instance of the KiteConnect client.

```APIDOC
## Constructor

### Description
Initializes the KiteConnect client with API credentials and configuration.

### Parameters
- **api_key** (string) - Required - API key issued by Kite
- **access_token** (string | null) - Optional - Token obtained after login flow
- **root** (string) - Optional - API endpoint root URL
- **login_uri** (string) - Optional - Kite login URL
- **debug** (boolean) - Optional - Enable console logging
- **timeout** (number) - Optional - Request timeout in milliseconds
```

--------------------------------

### Handle connect event

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/api-reference/KiteTicker.md

Triggered upon successful WebSocket connection establishment. Use this to initiate subscriptions.

```typescript
ticker.on('connect', () => {
  console.log('Connected');
  ticker.subscribe([738561, 256265]);
});
```

--------------------------------

### new KiteTicker(params)

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/configuration.md

Initializes a new KiteTicker instance with the required API credentials and optional reconnection settings.

```APIDOC
## new KiteTicker(params)

### Description
Initializes the KiteTicker WebSocket client. The constructor accepts a configuration object to manage authentication and reconnection behavior.

### Parameters
- **api_key** (string) - Required - The API key provided by KiteConnect.
- **access_token** (string) - Required - The access token used for WebSocket authentication.
- **reconnect** (boolean) - Optional - Enable automatic reconnection on connection loss. Defaults to true.
- **max_retry** (number) - Optional - Maximum number of reconnection attempts. Defaults to 50. Set to -1 for infinite retries.
- **max_delay** (number) - Optional - Maximum delay between reconnection attempts in seconds. Defaults to 60.
- **root** (string) - Optional - The WebSocket endpoint URL. Defaults to wss://ws.kite.trade/.

### Usage Example
```typescript
const ticker = new KiteTicker({
  api_key: 'your_api_key',
  access_token: 'your_access_token',
  reconnect: true,
  max_retry: 50,
  max_delay: 60
});
```
```

--------------------------------

### Place MF SIP

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Creates a new SIP with specified parameters.

```http
POST /mf/sips
Authorization: token {api_key}:{access_token}
Content-Type: application/x-www-form-urlencoded

tradingsymbol=SOMEMF&amount=5000&frequency=monthly&instalments=12&initial_amount=0&instalment_day=1
```

--------------------------------

### Initialize KiteTicker

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/api-reference/KiteTicker.md

Instantiate the KiteTicker client with required API credentials and configuration parameters.

```typescript
import { KiteTicker } from 'kiteconnect';

const ticker = new KiteTicker({
  api_key: 'your_api_key',
  access_token: 'your_access_token',
  reconnect: true,
  max_retry: 50,
  max_delay: 60
});
```

--------------------------------

### KiteConnect.placeOrder()

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/types.md

Parameters required for placing a new order via the KiteConnect SDK.

```APIDOC
## KiteConnect.placeOrder(params: PlaceOrderParams)

### Description
Places a new order on the exchange.

### Parameters
- **exchange** (Exchanges) - Required - Exchange code
- **tradingsymbol** (string) - Required - Trading symbol
- **transaction_type** (TransactionTypes) - Required - BUY or SELL
- **order_type** (OrderTypes) - Required - MARKET, LIMIT, SL, SL-M
- **product** (Products) - Required - MIS, CNC, or NRML
- **quantity** (number) - Required - Number of shares/units
- **variety** (Varieties) - Optional - Order variety (default: regular)
- **validity** (Validities) - Optional - DAY, IOC, or TTL (default: DAY)
- **price** (number) - Optional - Price (required for LIMIT/SL orders)
- **market_protection** (number) - Optional - Market protection: -1 (auto), 0, or 1-100 (%)
- **autoslice** (boolean) - Optional - Enable order slicing for freeze limit (default: false)
- **algo_id** (string) - Optional - Associated algo ID
- **tag** (string) - Optional - Custom order tag
```

--------------------------------

### Get Order History

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves the status history for a specific order.

```http
GET /orders/{order_id}
Authorization: token {api_key}:{access_token}
```

--------------------------------

### Configure WebSocket for different network conditions

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/configuration.md

Initialize KiteTicker with specific retry and delay parameters based on network stability.

```typescript
const ticker = new KiteTicker({
  api_key,
  access_token,
  reconnect: true,
  max_retry: 20,
  max_delay: 30
});
```

```typescript
const ticker = new KiteTicker({
  api_key,
  access_token,
  reconnect: true,
  max_retry: -1,     // Infinite retries
  max_delay: 120     // Up to 2 minutes
});
```

```typescript
const ticker = new KiteTicker({
  api_key,
  access_token,
  reconnect: false   // Manual reconnection for testing
});
```

--------------------------------

### Order Placement Endpoint Reference

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/INDEX.md

Reference for the order placement endpoint structure and its corresponding client method.

```text
POST /orders/{variety}
placeOrder(variety, params)
Response: { data: { order_id, [children: [...]] } }
```

--------------------------------

### Connect to Kite Ticker

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/api-reference/KiteTicker.md

Establishes a WebSocket connection. Emits a 'connect' event upon success.

```typescript
ticker.connect();
console.log('Connection initiated');
```

--------------------------------

### Get Mutual Fund Holdings

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieve the current mutual fund holdings.

```http
GET /mf/holdings
Authorization: token {api_key}:{access_token}
```

--------------------------------

### GET /quote/ltp

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves the Last Traded Price (LTP) for specified instruments.

```APIDOC
## GET /quote/ltp

### Description
Retrieves the Last Traded Price (LTP) for specified instruments.

### Method
GET

### Endpoint
/quote/ltp

### Parameters
#### Query Parameters
- **i** (string) - Required - Instruments in 'EXCHANGE:TRADINGSYMBOL' format, multiple values supported.

### Response
#### Success Response (200)
- **data** (object) - Map of instrument keys to LTP data.

### Status Codes
- 200: Success
- 400: Invalid instruments
- 401: Unauthorized
```

--------------------------------

### KiteTickerParams

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/types.md

Configuration parameters for initializing the KiteTicker WebSocket client.

```APIDOC
## KiteTickerParams

### Description
Configuration parameters for KiteTicker class initialization.

### Parameters
- **api_key** (string) - Required - API key
- **access_token** (string) - Required - Access token
- **reconnect** (boolean) - Optional - Default: true - Enable auto-reconnection
- **max_retry** (number) - Optional - Default: 50 - Max reconnection attempts (max 300)
- **max_delay** (number) - Optional - Default: 60 - Max delay between retries in seconds (min 5s)
- **root** (string) - Optional - Default: wss://ws.kite.trade/ - WebSocket endpoint
```

--------------------------------

### POST /mf/sips

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Place a new Mutual Fund SIP.

```APIDOC
## POST /mf/sips

### Description
Create a new Mutual Fund SIP order.

### Method
POST

### Endpoint
/mf/sips

### Request Body
- **tradingsymbol** (string) - Required
- **amount** (number) - Required
- **frequency** (string) - Required
- **instalments** (number) - Required
- **initial_amount** (number) - Required
- **instalment_day** (number) - Required

### Response
#### Success Response (200)
- **data** (object) - Contains the sip_id.

### Status Codes
- 200: Success
- 400: Invalid parameters
- 401: Unauthorized
```

--------------------------------

### GET /orders/{order_id}/trades

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves the trades executed for a specific order.

```APIDOC
## GET /orders/{order_id}/trades

### Description
Retrieves the trades executed for a specific order.

### Method
GET

### Endpoint
/orders/{order_id}/trades

### Response
#### Success Response (200)
- **data** (array) - List of trade objects.
```

--------------------------------

### KiteConnect.getvirtualContractNote()

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/types.md

Parameters required for calculating virtual contract note charges.

```APIDOC
## KiteConnect.getvirtualContractNote(params: VirtualContractParam)

### Description
Calculates charges for a virtual contract note.

### Parameters
- **order_id** (number | string) - Imaginary order ID for calculation
- **exchange** (Exchanges) - Exchange code
- **tradingsymbol** (string) - Trading symbol
- **transaction_type** (TransactionTypes) - BUY or SELL
- **variety** (Varieties) - Order variety
- **product** (Products) - Product type
- **order_type** (OrderTypes) - Order type
- **quantity** (number) - Quantity executed
- **average_price** (number) - Average execution price (must be non-zero)
```

--------------------------------

### GET /user/margins

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves margin information for the user, optionally filtered by segment.

```APIDOC
## GET /user/margins/{segment}

### Description
Retrieves margin information for the user, optionally filtered by segment.

### Method
GET

### Endpoint
/user/margins/{segment}

### Parameters
#### Path Parameters
- **segment** (string) - Optional - 'equity' or 'commodity'

### Response
#### Success Response (200)
- **data** (object) - Margin details for equity and/or commodity segments.
```

--------------------------------

### ResourceException Handling

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/errors.md

Represents a 404 Not Found error. Use this to catch missing resources like invalid order IDs.

```typescript
{
  error_type: 'ResourceException',
  message: 'Order not found',
  data: null
}
```

```typescript
try {
  const history = await kc.getOrderHistory('invalid_order_id');
} catch (err) {
  if (err.error_type === 'ResourceException') {
    console.error('Order not found');
  }
}
```

--------------------------------

### Get Order Trades

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves the trade executions associated with a specific order.

```http
GET /orders/{order_id}/trades
Authorization: token {api_key}:{access_token}
```

--------------------------------

### placeOrder()

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/api-reference/KiteConnect.md

Places an order with the specified parameters.

```APIDOC
## placeOrder(variety, params)

### Description
Places an order with the specified parameters. Supports autoslicing for large quantities.

### Parameters
- **variety** (Varieties) - Required - Order variety ('regular', 'amo', 'co', 'iceberg', 'auction').
- **params** (PlaceOrderParams) - Required - Order parameters including exchange, symbol, side, type, quantity, etc.

### Returns
- **Promise<any>** - Object with order_id and optionally a children array.
```

--------------------------------

### placeMFSIP

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/api-reference/KiteConnect.md

Places a new mutual fund SIP.

```APIDOC
## placeMFSIP(params: Order)

### Description
Places a mutual fund SIP (Systematic Investment Plan).

### Parameters
- **params** (Order) - Required - SIP parameters (tradingsymbol, amount, frequency, instalments, instalment_day, tag)

### Returns
- **Promise<any>** - SIP response with sip_id
```

--------------------------------

### Get OHLC

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieve Open, High, Low, and Close data for specified instruments.

```http
GET /quote/ohlc?i=NSE:INFY&i=NSE:TCS
Authorization: token {api_key}:{access_token}
```

--------------------------------

### Configure Proxy via Environment Variables

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/configuration.md

Set standard Node.js environment variables to route requests through a proxy server.

```typescript
// Would require custom implementation by extending the request logic
// For now, use Node.js environment variables
process.env.HTTP_PROXY = 'http://proxy.example.com:8080';
process.env.HTTPS_PROXY = 'https://proxy.example.com:8443';
```

--------------------------------

### Handle Postback Validation

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/errors.md

Demonstrates how to verify postback authenticity and handle potential validation errors.

```typescript
try {
  const isValid = kc.validatePostback(postbackData, apiSecret);
  if (isValid) {
    console.log('Postback is authentic');
  } else {
    console.error('Postback checksum mismatch - possible tampering');
  }
} catch (err) {
  console.error('Postback validation failed:', err.message);
}
```

--------------------------------

### KiteTicker WebSocket Methods

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/INDEX.md

Methods for managing real-time WebSocket connections and data streaming.

```APIDOC
## KiteTicker WebSocket Methods

- `connect()`: Connect to stream
- `disconnect()`: Disconnect from stream
- `connected()`: Check connection status
- `subscribe()`: Subscribe to instruments
- `unsubscribe()`: Unsubscribe from instruments
- `setMode()`: Set tick data mode
- `on()`: Register event listener
- `autoReconnect()`: Configure auto-reconnection
- `parseBinary()`: Parse binary tick data
```

--------------------------------

### Get Mutual Fund Orders

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieve all mutual fund orders or a specific order by ID.

```http
GET /mf/orders
Authorization: token {api_key}:{access_token}
```

--------------------------------

### GET /quote/ohlc

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieves OHLC (Open, High, Low, Close) data for specified instruments.

```APIDOC
## GET /quote/ohlc

### Description
Retrieves OHLC (Open, High, Low, Close) data for specified instruments.

### Method
GET

### Endpoint
/quote/ohlc

### Parameters
#### Query Parameters
- **i** (string) - Required - Instruments in 'EXCHANGE:TRADINGSYMBOL' format, multiple values supported.

### Response
#### Success Response (200)
- **data** (object) - Map of instrument keys to OHLC data.

### Status Codes
- 200: Success
- 400: Invalid instruments
- 401: Unauthorized
```

--------------------------------

### Stream market data with WebSocket

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/README.md

Use KiteTicker to subscribe to instrument tokens and handle real-time tick updates.

```typescript
import { KiteTicker } from 'kiteconnect';

const ticker = new KiteTicker({
  api_key: 'your_api_key',
  access_token: 'your_access_token'
});

ticker.on('connect', () => {
  const tokens = [738561, 256265];
  ticker.subscribe(tokens);
  ticker.setMode(ticker.modeFull, tokens);
});

ticker.on('ticks', (ticks) => {
  ticks.forEach(tick => {
    console.log(tick.instrument_token, tick.last_price);
  });
});

ticker.on('error', (error) => {
  console.error('Error:', error);
});

ticker.connect();
```

--------------------------------

### Get Historical Data

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieve historical candle data for a specific instrument token and interval.

```http
GET /instruments/historical/738561/5minute?from=2024-01-01+09:15:00&to=2024-01-31+15:30:00&continuous=0&oi=0
Authorization: token {api_key}:{access_token}
```

--------------------------------

### KiteConnectParams

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/types.md

Configuration parameters required for initializing the KiteConnect class.

```APIDOC
## KiteConnectParams

### Description
Configuration parameters for `KiteConnect` class initialization.

### Parameters
- **api_key** (string) - Required - API key issued by Kite
- **access_token** (string | null) - Optional - Session token after login
- **root** (string) - Optional - API endpoint URL (Default: https://api.kite.trade)
- **login_uri** (string) - Optional - Login page URL (Default: https://kite.zerodha.com/connect/login)
- **debug** (boolean) - Optional - Enable request/response logging (Default: false)
- **timeout** (number) - Optional - Request timeout in milliseconds (Default: 7000)
```

--------------------------------

### Define Node.js version requirements

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/configuration.md

Specify minimum Node.js version in package.json to ensure compatibility.

```json
{
  "engines": {
    "node": ">=18.0.0"
  },
  "engineStrict": true
}
```

--------------------------------

### Get Specific GTT Trigger

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Retrieve details for a specific GTT trigger using its trigger ID.

```http
GET /gtt/triggers/{trigger_id}
Authorization: token {api_key}:{access_token}
```

--------------------------------

### Retrieve All Orders

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/api-reference/KiteConnect.md

Fetches the list of all orders for the user.

```typescript
const orders = await kc.getOrders();
orders.forEach(order => {
  console.log(order.order_id, order.status, order.order_timestamp);
});
```

--------------------------------

### Authentication Routes

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/configuration.md

Endpoints for managing user sessions and tokens.

```APIDOC
## POST /session/token
### Description
Generate a session token.

## DELETE /session/token
### Description
Logout and invalidate the session token.

## POST /session/refresh_token
### Description
Refresh an existing session token.
```

--------------------------------

### Place MF SIP

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/api-reference/KiteConnect.md

Places a new mutual fund SIP order.

```typescript
placeMFSIP(params: Order): Promise<any>
```

--------------------------------

### Handle GTT Validation Errors

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/errors.md

Example of catching and identifying specific GTT parameter validation errors.

```typescript
try {
  await kc.placeGTT(gttParams);
} catch (err) {
  if (err instanceof Error && err.message.includes('trigger_type')) {
    console.error('Invalid GTT trigger type');
  } else if (err instanceof Error && err.message.includes('trigger_values')) {
    console.error('Invalid number of trigger values for order type');
  }
}
```

--------------------------------

### on(e, callback)

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/api-reference/KiteTicker.md

Registers an event listener for a specific KiteTicker event. Multiple listeners can be registered for the same event.

```APIDOC
## on(e, callback)

### Description
Registers an event listener for a specific event. Multiple listeners can be registered for the same event.

### Parameters
- **e** (KiteTickerEvents) - Required - Event name ('connect', 'ticks', 'disconnect', 'error', 'close', 'reconnect', 'noreconnect', 'message', 'order_update')
- **callback** (Function) - Required - Callback function (signature varies by event)

### Returns
- **void**

### Example
```typescript
ticker.on('connect', () => {
  console.log('Connected to stream');
});
```
```

--------------------------------

### Place Order

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Submits a new order to the exchange.

```http
POST /orders/{variety}
Authorization: token {api_key}:{access_token}
Content-Type: application/x-www-form-urlencoded

exchange=NSE&tradingsymbol=INFY&transaction_type=BUY&order_type=LIMIT&product=MIS&quantity=1&price=1500&validity=DAY&[...other_params...]
```

--------------------------------

### KiteConnect SDK Methods

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/INDEX.md

Methods available for interacting with the KiteConnect API for authentication, orders, portfolio, market data, margins, mutual funds, and GTT.

```APIDOC
## KiteConnect SDK Methods

### Authentication
- `generateSession()`: Create session from request token
- `renewAccessToken()`: Refresh expired access token
- `invalidateAccessToken()`: Log out
- `invalidateRefreshToken()`: Invalidate refresh token
- `setAccessToken()`: Set token manually
- `setSessionExpiryHook()`: Register session expiry callback
- `getLoginURL()`: Get login page URL

### Orders
- `placeOrder()`: Place new order
- `modifyOrder()`: Modify pending order
- `cancelOrder()`: Cancel pending order
- `exitOrder()`: Exit order (bracket/cover)
- `getOrders()`: Get all orders
- `getOrderHistory()`: Get order state history
- `getTrades()`: Get all trades
- `getOrderTrades()`: Get trades for order

### Portfolio
- `getHoldings()`: Get holdings
- `getAuctionInstruments()`: Get auction instruments
- `getPositions()`: Get open positions
- `convertPosition()`: Convert position product

### Market Data
- `getInstruments()`: Get instrument list
- `getQuote()`: Get quote data
- `getOHLC()`: Get OHLC data
- `getLTP()`: Get last traded price
- `getHistoricalData()`: Get candles

### Margins
- `getMargins()`: Get account margins
- `orderMargins()`: Calculate order margins
- `orderBasketMargins()`: Calculate basket margins
- `getvirtualContractNote()`: Calculate charges

### Mutual Funds
- `getMFOrders()`: Get MF orders
- `placeMFOrder()`: Place MF order
- `cancelMFOrder()`: Cancel MF order
- `getMFHoldings()`: Get MF holdings
- `getMFInstruments()`: Get MF instruments
- `getMFSIPS()`: Get SIPs
- `placeMFSIP()`: Place SIP
- `modifyMFSIP()`: Modify SIP
- `cancelMFSIP()`: Cancel SIP

### GTT
- `getGTTs()`: Get all GTT triggers
- `getGTT()`: Get specific GTT
- `placeGTT()`: Place GTT order
- `modifyGTT()`: Modify GTT order
- `deleteGTT()`: Delete GTT order

### Validation
- `validatePostback()`: Verify postback authenticity
```

--------------------------------

### KiteConnect.orderMargins()

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/types.md

Parameters required for calculating margins for an order.

```APIDOC
## KiteConnect.orderMargins(params: MarginOrder[])

### Description
Calculates the margin requirements for a list of orders.

### Parameters
- **exchange** (Exchanges) - Exchange code
- **tradingsymbol** (string) - Trading symbol
- **transaction_type** (TransactionTypes) - BUY or SELL
- **variety** (Varieties) - Order variety
- **product** (Products) - Product type
- **order_type** (OrderTypes) - Order type
- **quantity** (number) - Quantity
- **price** (number) - Order price
- **trigger_price** (number) - Trigger price (for SL orders)
```

--------------------------------

### placeGTT

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/api-reference/KiteConnect.md

Places a new GTT order.

```APIDOC
## placeGTT(params: PlaceGTTParams)

### Description
Places a new GTT (Good Till Trigger) order. Supports both single-leg and two-leg (OCO) orders.

### Parameters
- **params** (PlaceGTTParams) - Required - GTT parameters with trigger type, condition, and orders array

### Returns
- **Promise<any>** - GTT response with trigger_id
```

--------------------------------

### Initialize KiteConnect Constructor

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/configuration.md

Defines the structure of the KiteConnectParams object used for client initialization.

```typescript
new KiteConnect({
  api_key: string,
  access_token?: string | null,
  root?: string,
  login_uri?: string,
  debug?: boolean,
  timeout?: number
})
```

--------------------------------

### Manage Mutual Fund Orders with TypeScript

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/api-reference/KiteConnect.md

Methods for retrieving, placing, and canceling mutual fund orders.

```typescript
getMFOrders(order_id?: string | number): Promise<any>
```

```typescript
placeMFOrder(params: PlaceMFOrderParams): Promise<any>
```

```typescript
cancelMFOrder(order_id: string | number): Promise<any>
```

--------------------------------

### getOrders()

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/api-reference/KiteConnect.md

Retrieves all orders for the user.

```APIDOC
## getOrders()

### Description
Retrieves all orders for the user.

### Returns
- **Promise<any>** - Array of order objects.
```

--------------------------------

### User Routes

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/configuration.md

Endpoints for retrieving user profile and margin information.

```APIDOC
## GET /user/profile
### Description
Retrieve the user profile.

## GET /user/margins
### Description
Retrieve user margins.

## GET /user/margins/{segment}
### Description
Retrieve margins for a specific segment.
```

--------------------------------

### PlaceGTTParams Interface

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/types.md

Parameters required for placing a GTT order via KiteConnect.placeGTT().

```typescript
interface PlaceGTTParams {
  trigger_type: GTTStatusTypes.GTT_TYPE_OCO | GTTStatusTypes.GTT_TYPE_SINGLE;
  tradingsymbol: string;
  exchange: Exchanges;
  trigger_values: Array<Number>;
  last_price: number;
  orders: {
    exchange: string;
    tradingsymbol: string;
    transaction_type: TransactionTypes;
    quantity: number;
    product: Products;
    order_type: OrderTypes;
    price: number;
  }[];
}
```

--------------------------------

### PlaceGTTParams

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/types.md

Parameters required for placing a GTT (Good Till Triggered) order.

```APIDOC
## PlaceGTTParams

### Description
Parameters for placing a GTT order.

### Parameters
- **trigger_type** ('single' | 'two-leg') - Required - Single-leg or OCO
- **tradingsymbol** (string) - Required - Trading symbol
- **exchange** (Exchanges) - Required - Exchange code
- **trigger_values** (Array<Number>) - Required - Trigger price(s): 1 for single, 2 for OCO
- **last_price** (number) - Required - Current market price
- **orders** (Array) - Required - Orders to place when triggered (1 for single, 2 for OCO)
```

--------------------------------

### Products Enum

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/types.md

Product types (equivalent to ProductTypes, alternative enum).

```typescript
enum Products {
  NRML = 'NRML',
  MIS = 'MIS',
  CNC = 'CNC'
}
```

--------------------------------

### Perform REST API operations

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/README.md

Initialize the KiteConnect client, generate a session, and execute common trading operations like placing orders and fetching holdings.

```typescript
import { KiteConnect } from 'kiteconnect';

const kc = new KiteConnect({ api_key: 'your_api_key' });

// Generate session (login)
const session = await kc.generateSession(requestToken, apiSecret);
kc.setAccessToken(session.access_token);

// Place order
const order = await kc.placeOrder('regular', {
  exchange: 'NSE',
  tradingsymbol: 'INFY',
  transaction_type: 'BUY',
  order_type: 'LIMIT',
  product: 'MIS',
  quantity: 1,
  price: 1500
});

// Get orders
const orders = await kc.getOrders();

// Get holdings
const holdings = await kc.getHoldings();

// Get quotes
const quotes = await kc.getQuote(['NSE:INFY', 'NSE:TCS']);
```

--------------------------------

### Convert Position Request

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/endpoints.md

Converts an existing position product type.

```http
PUT /portfolio/positions
Authorization: token {api_key}:{access_token}
Content-Type: application/x-www-form-urlencoded

exchange=NSE&tradingsymbol=INFY&transaction_type=BUY&position_type=day&quantity=10&old_product=MIS&new_product=CNC
```

--------------------------------

### Retrieve Quotes with TypeScript

Source: https://github.com/zerodha/kiteconnectjs/blob/master/_autodocs/api-reference/KiteConnect.md

Fetches bid/ask prices and volume for specified instruments using the 'EXCHANGE:TRADINGSYMBOL' format.

```typescript
getQuote(instruments: string | string[]): Promise<any>
```

```typescript
const quote = await kc.getQuote(['NSE:INFY', 'NSE:TCS']);
console.log(quote['NSE:INFY'].last_price);
```
Tokens:
Raw