Official instructions from Zerodha for setting up an AI coding agent to build on Kite Connect with the official Python client, pykiteconnect. Kite Connect is a set of REST-like HTTP APIs for trading, portfolio management, and live market data on Indian exchanges (NSE, BSE, MCX).

Set up the environment, then write code from the SDK examples and use these docs as the API reference.

---

## 1. Install with uv

Prefer uv for installing and running Python.

In a project:

```
uv init my-kite-app && cd my-kite-app
uv add kiteconnect
```

Or run a one-off script:

```
uv run --with kiteconnect main.py
```

---

## 2. Authenticate

Kite Connect uses an OAuth-style login flow. Send the user to `kite.login_url()`, capture the `request_token` from the registered redirect URL, then exchange it for an `access_token`. Never ask the user for their password, and never hardcode the `api_secret`.

```python
from kiteconnect import KiteConnect

kite = KiteConnect(api_key="your_api_key")
data = kite.generate_session("request_token", api_secret="your_api_secret")
kite.set_access_token(data["access_token"])
```

---

## 3. Write code from the SDK examples

Read the example files first. They are the fastest path to correct, idiomatic code: https://github.com/zerodha/pykiteconnect/tree/master/examples

Common calls:

- Place an order (returns `order_id`):

```python
order_id = kite.place_order(
    variety=kite.VARIETY_REGULAR,
    exchange=kite.EXCHANGE_NSE,
    tradingsymbol="INFY",
    transaction_type=kite.TRANSACTION_TYPE_BUY,
    quantity=1,
    product=kite.PRODUCT_CNC,
    order_type=kite.ORDER_TYPE_LIMIT,
    price=1500,
    validity=kite.VALIDITY_DAY,
)
```

- Read state: `kite.orders()`, `kite.positions()`, `kite.holdings()`.
- Stream live data: use `KiteTicker` with `on_ticks` / `on_connect` callbacks.

---

## 4. Use the docs as the API reference

Every documentation page is available as Markdown by appending `.md` to its path:

- https://kite.trade/docs/connect/v3/index.md: Introduction, authentication, API conventions
- https://kite.trade/docs/connect/v3/user/index.md: Login flow and access tokens
- https://kite.trade/docs/connect/v3/orders/index.md: Placing, modifying, and cancelling orders
- https://kite.trade/docs/connect/v3/portfolio/index.md: Holdings and positions
- https://kite.trade/docs/connect/v3/market-quotes/index.md: Market quotes and instruments
- https://kite.trade/docs/connect/v3/websocket/index.md: Live market data streaming

The full index is at https://kite.trade/docs/connect/v3/.

---

## Resources

- Python SDK: https://github.com/zerodha/pykiteconnect
- Python SDK reference: https://kite.trade/docs/pykiteconnect/v4
- Developer forum: https://kite.trade/forum/

These instructions are published at `https://kite.trade/docs/connect/v3/agent-setup/prompt.md` so you can re-verify their authenticity.