canonical: https://jentic.com/apis/smartapi.angelbroking.com/smartapi-angelbroking

# Smartapi Angelbroking Angel One SmartAPI

SmartAPI by Angel One (formerly Angel Broking) provides comprehensive trading APIs for Indian stock markets. Enables order placement, market data access, portfolio management, and real-time data streaming for equities, derivatives, commodities, and currency trading. The API exposes 21 endpoints secured with apiKey, bearer authentication.

## For AI agents

Programmatically generate session, generate token. Covers 21 operations with apiKey, bearer authentication.

## Scope

Does not handle payments, communications, or crm - use for e-commerce only.

## Capabilities

- Generate Session
- Terminate Session
- Get Profile
- Place Order
- Modify Order

## Use cases

### E-Commerce Operations

Use the Angel One SmartAPI to perform e commerce operations programmatically. The API provides 21 endpoints covering core functionality including generate session, generate token, terminate session.

Example prompt: Call POST /rest/auth/angelbroking/user/v1/loginByPassword to generate session

### Automated Authentication Management

Automate authentication operations by combining multiple Angel One SmartAPI endpoints. Agents can generate token and then terminate session in a single workflow.

Example prompt: Call POST /rest/auth/angelbroking/jwt/v1/generateTokens to generate token, then verify the result

### AI Agent Integration via Jentic

AI agents discover and call Angel One SmartAPI endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle apiKey, bearer tokens manually.

Example prompt: Search Jentic for 'generate session', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | /rest/auth/angelbroking/user/v1/loginByPassword | Generate Session |
| POST | /rest/auth/angelbroking/jwt/v1/generateTokens | Generate Token |
| POST | /rest/secure/angelbroking/user/v1/logout | Terminate Session |
| GET | /rest/secure/angelbroking/user/v1/getProfile | Get Profile |
| GET | /rest/secure/angelbroking/user/v1/getRMS | Get RMS Limits |
| POST | /rest/secure/angelbroking/order/v1/placeOrder | Place Order |
| POST | /rest/secure/angelbroking/order/v1/modifyOrder | Modify Order |
| POST | /rest/secure/angelbroking/order/v1/cancelOrder | Cancel Order |

## Key resources

- **Authentication** — Session management and authentication
- **User** — User profile and account information
- **Orders** — Order placement, modification, and tracking
- **Portfolio** — Holdings and positions management
- **Market Data** — Real-time and historical market data

## Why Jentic

- **Setup:** Wiring Angel One SmartAPI by hand means logging in for a JWT bearer token and sending its client IP, MAC, and private-key headers on every call, plus managing retries yourself. Through Jentic you install once, import the Angel One SmartAPI from the API Directory, store the credentials once, and your agent calls it.
- **Permission scoping:** Angel One SmartAPI carries the order id in the request body rather than the URL path, so scope the agent to the operations it needs, such as fetching the profile and placing an order. You choose which operations are allowed, so cancelOrder and modifyOrder are not included unless you add them.
- **Credential handling:** Your Angel One credentials are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'place a trade order' or 'get my portfolio profile', and Jentic returns the matching Angel One SmartAPI operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Shopify** — Alternative e commerce API
- **Stripe** — Alternative e commerce API

## FAQ

### What authentication does the Angel One SmartAPI use?

The Angel One SmartAPI uses apiKey, bearer authentication. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I generate session with the Angel One SmartAPI?

Yes. Use the POST /rest/auth/angelbroking/user/v1/loginByPassword endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the Angel One SmartAPI?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I generate session through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'generate session'. Jentic returns the matching Angel One SmartAPI operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the Angel One SmartAPI have?

The Angel One SmartAPI exposes 21 endpoints covering authentication, user, orders operations.

### Can I limit what my agent is allowed to do with the Angel One SmartAPI?

Yes. Because you self-host Jentic One, your own rules decide which Angel One SmartAPI operations and credentials the agent can use. You can allow just the calls it needs, such as getProfile and placeOrder, while leaving modifyOrder and cancelOrder out unless you add them. Since the order id travels in the request body rather than the URL path, scoping is enforced at the operation level, so the agent only ever invokes the endpoints you have permitted.