SmartAPI Angel Broking

https://smartapi.angelbroking.com/docs
Admin
SmartAPI is a REST-like HTTP API marketplace providing trading capabilities including real-time...
Tokens:395,142
Snippets:1,500
Trust Score:10
Update:2 weeks ago
Show doc for...
Tokens:
Raw
### Get All Holdings with OkHttp (Java)

Source: https://smartapi.angelbroking.com/docs/CASDoc

Java example using OkHttpClient to send a GET request to the getAllHolding endpoint. Requires the same placeholder values as other examples.

```java
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
Request request = new Request.Builder()
  .url("https://apiconnect.angelone.in/
  rest/secure/angelbroking/portfolio/v1/getAllHolding")

  .method("GET", null)
  .addHeader("Authorization", "Bearer AUTHORIZATION_TOKEN")
  .addHeader("Content-Type", "application/json")
  .addHeader("Accept", "application/json")
  .addHeader("X-UserType", "USER")
  .addHeader("X-SourceID", "WEB")
  .addHeader("X-ClientLocalIP", "CLIENT_LOCAL_IP")
  .addHeader("X-ClientPublicIP", "CLIENT_PUBLIC_IP")
  .addHeader("X-MACAddress", "MAC_ADDRESS")
  .addHeader("X-PrivateKey", "API_KEY")
  .build();
Response response = client.newCall(request).execute();
```

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

### Get Profile with Go net/http

Source: https://smartapi.angelbroking.com/docs/CASDoc

Go example using net/http to call the Get Profile endpoint. Requires replacing placeholders with actual credentials.

```go
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://apiconnect.angelone.in/
  rest/secure/angelbroking/user/v1/getProfile"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Authorization", "Bearer AUTHORIZATION_TOKEN")
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Accept", "application/json")
  req.Header.Add("X-UserType", "USER")
  req.Header.Add("X-SourceID", "WEB")
  req.Header.Add("X-ClientLocalIP", "CLIENT_LOCAL_IP")
  req.Header.Add("X-ClientPublicIP", "CLIENT_PUBLIC_IP")
  req.Header.Add("X-MACAddress", "MAC_ADDRESS")
  req.Header.Add("X-PrivateKey", "API_KEY")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
```

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

### Python Example

Source: https://smartapi.angelbroking.com/docs/TopGainers

Python example using http.client to call the estimateCharges endpoint.

```APIDOC
## [POST] https://apiconnect.angelone.in/rest/secure/angelbroking/brokerage/v1/estimateCharges

### Description
Calculates brokerage charges and taxes for placing a trade.

### Method
POST

### Endpoint
https://apiconnect.angelone.in/rest/secure/angelbroking/brokerage/v1/estimateCharges

### Parameters
#### Request Body
- **orders** (array) - Required - List of orders for which charges are to be estimated.
  - **product_type** (string) - Required - Product type (e.g., DELIVERY).
  - **transaction_type** (string) - Required - Transaction type (e.g., BUY).
  - **quantity** (string) - Required - Quantity of the order.
  - **price** (string) - Required - Price of the order.
  - **exchange** (string) - Required - Exchange (e.g., NSE, BSE).
  - **symbol_name** (string) - Required - Symbol name of the instrument.
  - **token** (string) - Required - Token of the instrument.

### Request Example
{
  "orders": [
    {
      "product_type": "DELIVERY",
      "transaction_type": "BUY",
      "quantity": "10",
      "price": "800",
      "exchange": "NSE",
      "symbol_name": "745AS33",
      "token": "17117"
    },
    {
      "product_type": "DELIVERY",
      "transaction_type": "BUY",
      "quantity": "10",
      "price": "800",
      "exchange": "BSE",
      "symbol_name": "PIICL151223",
      "token": "726131"
    }
  ]
}

### Response
#### Success Response (200)
- **status** (boolean) - Indicates success.
- **message** (string) - Response message.
- **errorcode** (string) - Error code if any.
- **data** (object) - Contains summary and charges.
  - **summary** (object) - Summary of total charges.
    - **total_charges** (number) - Total charges.
    - **trade_value** (number) - Total trade value.
    - **breakup** (array) - Breakup of charges.
  - **charges** (array) - Per-order charge details.

#### Response Example
{
  "status": true,
  "message": "SUCCESS",
  "errorcode": "",
  "data": {
    "summary": {
      "total_charges": 3.0796,
      "trade_value": 16000,
      "breakup": [
        {
          "name": "Angel One Brokerage",
          "amount": 0.0,
          "msg": "",
          "breakup": []
        },
        {
          "name": "External Charges",
          "amount": 2.976,
          "msg": "",
          "breakup": [
            {
              "name": "Exchange Transaction Charges",
              "amount": 0.56,
              "msg": "",
              "breakup": []
            },
            {
              "name": "Stamp Duty",
              "amount": 2.4,
              "msg": "",
              "breakup": []
            },
            {
              "name": "SEBI Fees",
              "amount": 0.016,
              "msg": "",
              "breakup": []
            }
          ]
        },
        {
          "name": "Taxes",
          "amount": 0.1036,
          "msg": "",
          "breakup": [
            {
              "name": "Security Transaction Tax",
              "amount": 0.0,
              "msg": "",
              "breakup": []
            },
            {
              "name": "GST",
              "amount": 0.1036,
              "msg": "",
              "breakup": []
            }
          ]
        }
      ]
    },
    "charges": [
      {
        "total_charges": 1.5162,
        "trade_value": 8000,
        "breakup": {
          "name": "Angel One Brokerage",
          "amount": 0.0,
          "msg": "",
          "breakup": []
        },
        {
          "name": "External Charges",
          "amount": 2.976,
          "msg": "",
          "breakup": [
            {
              "name": "Exchange Transaction Charges",
              "amount": 0.56,
              "msg": "",
              "breakup": []
            },
            {
              "name": "Stamp Duty",
              "amount": 2.4,
              "msg": "",
              "breakup": []
            },
            {
              "name": "SEBI Fees",
              "amount": 0.016,
              "msg": "",
              "breakup": []
            }
          ]
        },
        {
          "name": "Taxes",
          "amount": 0.1036,
          "msg": "",
          "breakup": [
            {
              "name": "Security Transaction Tax",
              "amount": 0.0,
              "msg": "",
              "breakup": []
            },
            {
              "name": "GST",
              "amount": 0.1036,
              "msg": "",
              "breakup": []
            }
          ]
        }
      },
      {
        "total_charges": 1.5634,
        "trade_value": 8000,
        "breakup": {
          "name": "Angel One Brokerage",
          "amount": 0.0,
          "msg": "",
          "breakup": []
        },
        {
          "name": "External Charges",
          "amount": 2.976,
          "msg": "",
          "breakup": [
            {
              "name": "Exchange Transaction Charges",
              "amount": 0.56,
              "msg": "",
              "breakup": []
            },
            {
              "name": "Stamp Duty",
              "amount": 2.4,
              "msg": "",
              "breakup": []
            },
            {
              "name": "SEBI Fees",
              "amount": 0.016,
              "msg": "",
              "breakup": []
            }
          ]
        },
        {
          "name": "Taxes",
          "amount": 0.1036,
          "msg": "",
          "breakup": [
            {
              "name": "Security Transaction Tax",
              "amount": 0.0,
              "msg": "",
              "breakup": []
            },
            {
              "name": "GST",
              "amount": 0.1036,
              "msg": "",
              "breakup": []
            }
          ]
        }
      }
    ]
  }
}
```

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

### Get Profile with OkHttp (Java)

Source: https://smartapi.angelbroking.com/docs/CASDoc

Java example using OkHttp to call the Get Profile endpoint. Requires OkHttp library and replacing placeholders with actual credentials.

```java
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
Request request = new Request.Builder()
  .url("https://apiconnect.angelone.in/
  rest/secure/angelbroking/user/
  v1/getProfile")

  .method("GET", null)
  .addHeader("Authorization", "Bearer AUTHORIZATION_TOKEN")
  .addHeader("Accept", "application/json")
  .addHeader("X-UserType", "USER")
  .addHeader("X-SourceID", "WEB")
  .addHeader("X-ClientLocalIP", "CLIENT_LOCAL_IP")
  .addHeader("X-ClientPublicIP", "CLIENT_PUBLIC_IP")
  .addHeader("X-MACAddress", "MAC_ADDRESS")
  .addHeader("X-PrivateKey", "API_KEY")
  .build();
Response response = client.newCall(request).execute();
```

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

### Get All Holdings with net/http (Go)

Source: https://smartapi.angelbroking.com/docs/CASDoc

Go example using net/http to perform a GET request to the getAllHolding endpoint. Includes error handling and prints the response body.

```go
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://apiconnect.angelone.in/
  rest/secure/angelbroking/portfolio/v1/getAllHolding"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Authorization", "Bearer AUTHORIZATION_TOKEN")
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Accept", "application/json")
  req.Header.Add("X-UserType", "USER")
  req.Header.Add("X-SourceID", "WEB")
  req.Header.Add("X-ClientLocalIP", "CLIENT_LOCAL_IP")
  req.Header.Add("X-ClientPublicIP", "CLIENT_PUBLIC_IP")
  req.Header.Add("X-MACAddress", "MAC_ADDRESS")
  req.Header.Add("X-PrivateKey", "API_KEY")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
```

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

### PCR Volume API - R Example

Source: https://smartapi.angelbroking.com/docs/CASDoc

R example using httr to call the PCR Volume API. Note: the example uses POST, but the API expects GET. Replace placeholders with your actual credentials.

```r
library(httr)

url <- "https://apiconnect.angelone.in/ 
rest/secure/angelbroking/order/
v1/putCallRatio"

response <- POST(url, 
    config = list(
    add_headers(
    'Authorization'= 'Bearer AUTHORIZATION_TOKEN',
    'Content-Type'= 'application/json',
    'Accept'= 'application/json',
    'X-UserType'= 'USER',
    'X-SourceID'= 'WEB',
    'X-ClientLocalIP'= 'CLIENT_LOCAL_IP',
    'X-ClientPublicIP'= 'CLIENT_PUBLIC_IP',
    'X-MACAddress'= 'MAC_ADDRESS',
    'X-PrivateKey'= 'API_KEY'
    ))
    ),
    encode = "raw"

print(response)
```

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

### Get Profile with httr (R)

Source: https://smartapi.angelbroking.com/docs/CASDoc

R example using httr to call the Get Profile endpoint. Requires httr library and replacing placeholders with actual credentials.

```r
library(httr)

url <- "https://apiconnect.angelone.in/
rest/secure/angelbroking/user/
v1/getProfile"

response <- GET(url, add_headers(
    'Authorization'= 'Bearer AUTHORIZATION_TOKEN',
    'Content-Type'= 'application/json',
    'Accept'= 'application/json',
    'X-UserType'= 'USER',
    'X-SourceID'= 'WEB',
    'X-ClientLocalIP'= 'CLIENT_LOCAL_IP',
    'X-ClientPublicIP'= 'CLIENT_PUBLIC_IP',
    'X-MACAddress'= 'MAC_ADDRESS',
    'X-PrivateKey'= 'API_KEY'
    ))

print(response)
```

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

### Place Order with OkHttp (Java)

Source: https://smartapi.angelbroking.com/docs/ResponseStructure

Example using OkHttp to POST an order to the Angel One API. Requires an authorization token and API key in headers.

```java
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\n
        \"exchange\": \"NSE\",\n    
        \"tradingsymbol\": \"INFY-EQ\",\n    
        \"quantity\": 5,\n    
        \"disclosedquantity\": 3,\n    
        \"transactiontype\": \"BUY\",\n   
        \"ordertype\": \"MARKET\",\n    
        \"variety\": \"NORMAL\",\n    
        \"producttype\": \"INTRADAY\",\n    
        \"scripconsent\": \"yes\"\n    }");

Request request = new Request.Builder()
  .url("https://apiconnect.angelone.in/ 
  rest/secure/angelbroking/order/
  v1/placeOrder")
  .method("POST", body)
  .addHeader("Authorization", "Bearer AUTHORIZATION_TOKEN")
  .addHeader("Content-Type", "application/json")
  .addHeader("Accept", "application/json")
  .addHeader("X-UserType", "USER")
  .addHeader("X-SourceID", "WEB")
  .addHeader("X-ClientLocalIP", "CLIENT_LOCAL_IP")
  .addHeader("X-ClientPublicIP", "CLIENT_PUBLIC_IP")
  .addHeader("X-MACAddress", "MAC_ADDRESS")
  .addHeader("X-PrivateKey", "API_KEY")
  .build();
Response response = client.newCall(request).execute();
```

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

### Python example for Brokerage Calculator API

Source: https://smartapi.angelbroking.com/docs/WebSocketOrderStatus

Python example using http.client to call the Brokerage Calculator API. It sets up an HTTPS connection to apiconnect.angelone.in and constructs the JSON payload with order details.

```python
import http.client
import mimetypes
conn = http.client.HTTPSConnection(
    "apiconnect.angelone.in"
    )
payload = "{\n
    \"orders\": [\n
        {\n
            \"product_type\": \"DELIVERY\",\n
            \"transaction_type\": \"BUY\",\n
            \"quantity\": \"10\",\n
            \"price\": \"800\",\n
            \"exchange\": \"NSE\",\n
            \"symbol_name\": \"SBIN-EQ\",\n
            \"token\": \"3045\"\n
        }\n
    ]\n
}", 
```

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

### Generate Token - Java

Source: https://smartapi.angelbroking.com/docs

Java example using OkHttpClient to call the generate token endpoint.

```APIDOC
## POST /rest/auth/angelbroking/jwt/v1/generateTokens

### Description
Generates a new JWT token and feed token using a refresh token obtained after login. This endpoint is used to obtain tokens for making transactions.

### Method
POST

### Endpoint
/rest/auth/angelbroking/jwt/v1/generateTokens

### Parameters
#### Request Body
- **refreshToken** (string) - Required - The refresh token obtained after successful login.

### Request Example
{
  "refreshToken": "REFRESH_TOKEN"
}

### Response
#### Success Response (200)
- **status** (boolean) - Indicates if the request was successful.
- **message** (string) - Response message.
- **errorcode** (string) - Error code if any.
- **data** (object) - Contains the generated tokens.
  - **jwtToken** (string) - The JWT token for making transactions.
  - **refreshToken** (string) - The refresh token for generating new tokens.
  - **feedToken** (string) - The feed token for market data.

#### Response Example
{
  "status": true,
  "message": "SUCCESS",
  "errorcode": "",
  "data": {
    "jwtToken": "eyJhbGciOiJIUzUxMiJ9.eyJzdWIi...",
    "refreshToken": "eyJhbGciOiJIUzUxMiJ9.e...",
    "feedToken": "eyJhbGciOiJIUzUxMiJ9.eyJ1c2Vy…"
  }
}
```

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

### GTT Rule List API Request Examples in Python, Java, JavaScript, R, and Go

Source: https://smartapi.angelbroking.com/docs/TopGainers

These are the API request examples for the GTT Rule List endpoint. They show how to send a POST request to /rest/secure/angelbroking/gtt/v1/ruleList with a JSON body containing status, page, and count. Each example uses the required headers including Authorization, X-UserType, X-SourceID, and X-PrivateKey. The response is printed or logged.

```python
import http.client

conn = http.client.HTTPSConnection("apiconnect.angelone.in")
payload = "{\r\n    \"status\": [\r\n        \"NEW\",\r\n     \"CANCELLED\",\r\n        \"ACTIVE\",\r\n      \"SENTTOEXCHANGE\",\r\n        \"FORALL\"\r\n    ],\r\n    \"page\": 1,\r\n    \"count\": 10\r\n}"
headers = {
  'Authorization': 'Bearer AUTHORIZATION_TOKEN',
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'X-UserType': 'USER',
  'X-SourceID': 'WEB',
  'X-ClientLocalIP': 'CLIENT_LOCAL_IP',
  'X-ClientPublicIP': 'CLIENT_PUBLIC_IP',
  'X-MACAddress': 'MAC_ADDRESS',
  'X-PrivateKey': 'API_KEY'
}
conn.request("POST", "/rest/secure/angelbroking/gtt/v1/ruleList", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```

```java
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n      \"status\": [\r\n        \"NEW\",\r\n       \"CANCELLED\",\r\n        \"ACTIVE\",\r\n            \"SENTTOEXCHANGE\",\r\n        \"FORALL\"\r\n    ],\r\n    \"page\": 1,\r\n    \"count\": 10\r\n}");
Request request = new Request.Builder()
  .url("https://apiconnect.angelone.in/rest/secure/angelbroking/gtt/v1/ruleList")
  .method("POST", body)
  .addHeader("Authorization", "Bearer AUTHORIZATION_TOKEN")
  .addHeader("Content-Type", "application/json")
  .addHeader("Accept", "application/json")
  .addHeader("X-UserType", "USER")
  .addHeader("X-SourceID", "WEB")
  .addHeader("X-ClientLocalIP", "CLIENT_LOCAL_IP")
  .addHeader("X-ClientPublicIP", "CLIENT_PUBLIC_IP")
  .addHeader("X-MACAddress", "MAC_ADDRESS")
  .addHeader("X-PrivateKey", "API_KEY")
  .build();
Response response = client.newCall(request).execute();
```

```javascript
var axios = require('axios');
var data = JSON.stringify({"status":["NEW","CANCELLED","ACTIVE","SENTTOEXCHANGE","FORALL"],"page":1,"count":10});

var config = {
  method: 'post',
  url: 'https://apiconnect.angelone.in/rest/secure/angelbroking/gtt/v1/ruleList\n',
  headers: { 
    'Authorization': 'Bearer AUTHORIZATION_TOKEN', 
    'Content-Type': 'application/json', 
    'Accept': 'application/json', 
    'X-UserType': 'USER', 
    'X-SourceID': 'WEB', 
    'X-ClientLocalIP': 'CLIENT_LOCAL_IP', 
    'X-ClientPublicIP': 'CLIENT_PUBLIC_IP', 
    'X-MACAddress': 'MAC_ADDRESS', 
    'X-PrivateKey': 'API_KEY'
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
```

```r
library(httr)

url <- "https://apiconnect.angelone.in/rest/secure/angelbroking/gtt/v1/ruleList"
json_body <- jsonlite::toJSON(list(
    "status": [
        "NEW",
        "CANCELLED",
        "ACTIVE",
        "SENTTOEXCHANGE",
        "FORALL"
    ],
    "page": 1,
    "count": 10

))

response <- POST(url, 
    config = list(
    add_headers(
    'Authorization'= 'Bearer AUTHORIZATION_TOKEN',
    'Content-Type'= 'application/json',
    'Accept'= 'application/json',
    'X-UserType'= 'USER',
    'X-SourceID'= 'WEB',
    'X-ClientLocalIP'= 'CLIENT_LOCAL_IP',
    'X-ClientPublicIP'= 'CLIENT_PUBLIC_IP',
    'X-MACAddress'= 'MAC_ADDRESS',
    'X-PrivateKey'= 'API_KEY'
    ))
    ),
    body = json_body,
    encode = "raw"

print(response)
```

```go
package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://apiconnect.angelone.in/rest/secure/angelbroking/gtt/v1/ruleList%0A"
  method := "POST"

  payload := strings.NewReader({
    "status": [
        "NEW",
        "CANCELLED",
        "ACTIVE",
        "SENTTOEXCHANGE",
        "FORALL"
    ],
    "page": 1,
    "count": 10
})

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Authorization", "Bearer AUTHORIZATION_TOKEN")
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Accept", "application/json")
  req.Header.Add("X-UserType", "USER")
  req.Header.Add("X-SourceID", "WEB")
  req.Header.Add("X-ClientLocalIP", "CLIENT_LOCAL_IP")
  req.Header.Add("X-ClientPublicIP", "CLIENT_PUBLIC_IP")
  req.Header.Add("X-MACAddress", "MAC_ADDRESS")
  req.Header.Add("X-PrivateKey", "API_KEY")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
```

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

### WebSocket Connection and Heartbeat

Source: https://smartapi.angelbroking.com/docs/WebSocket2

Documentation for WebSocket connection setup and heartbeat messaging for the Smart API streaming service.

```APIDOC
## WebSocket Connection URL

### Description
Connect to the Smart API WebSocket streaming endpoint. For browser-based clients, append the required query parameters to the URL.

### Method
WebSocket

### Endpoint
wss://smartapisocket.angelone.in/smart-stream

### Parameters
#### Query Parameters
- **clientCode** (string) - Required - Angel One Client Code
- **feedToken** (string) - Required - feedToken received in login response
- **apiKey** (string) - Required - Your API Key

### Request Example
```
wss://smartapisocket.angelone.in/smart-stream?clientCode=<clientCode>&feedToken=<feedToken>&apiKey=<apiKey>
```

### Response
#### Success Response
WebSocket connection established.

#### Error Response
HTTP status code 401 with response header `x-error-message` containing textual description of why authentication failed.

## Heartbeat Message

### Description
Send a heartbeat message every 30 seconds to keep the WebSocket connection alive.

### Method
WebSocket Text Message

### Request Example
```
ping
```

### Response Example
```
pong
```
```

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

### Get Position API Response

Source: https://smartapi.angelbroking.com/docs/TopGainers

Example response from the Get Position API. Shows a successful call with status true and a data array containing one position object with fields such as exchange, symboltoken, tradingsymbol, buyqty, sellqty, netqty, and netprice.

```json
{
  "status": true,
  "message": "SUCCESS",
  "errorcode": "",
  "data": [
    {
      "exchange": "NSE",
      "symboltoken": "2885",
      "producttype": "DELIVERY",
      "tradingsymbol": "RELIANCE-EQ",
      "symbolname": "RELIANCE",
      "instrumenttype": "",
      "priceden": "1",
          "pricenum": "1",
      "genden": "1",
      "gennum": "1",
      "precision": "2",
      "multiplier": "-1",
      "boardlotsize": "1",
      "buyqty": "1",
      "sellqty": "0",
      "buyamount": "2235.80",
      "sellamount": "0",
      "symbolgroup": "EQ",
      "strikeprice": "-1",
      "optiontype": "",
      "expirydate": "",
      "lotsize": "1",
      "cfbuyqty": "0",
      "cfsellqty": "0",
      "cfbuyamount": "0",
      "cfsellamount": "0",
      "buyavgprice": "2235.80",
      "sellavgprice": "0",
      "avgnetprice": "2235.80",
      "netvalue": "- 2235.80",
      "netqty": "1",
      "totalbuyvalue": "2235.80",
      "totalsellvalue": "0",
      "cfbuyavgprice": "0",
      "cfsellavgprice": "0",
      "totalbuyavgprice": "2235.80",
      "totalsellavgprice": "0",
      "netprice": "2235.80"
    }
  ]
}
```

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

### GTT Rule List API Request Examples

Source: https://smartapi.angelbroking.com/docs/WebSocketOrderStatus

These are the API request examples for the GTT Rule List endpoint. They show how to POST a JSON payload with status, page, and count to retrieve a list of GTT rules. Each example uses the same endpoint and headers, differing only in the client library or language.

```python
import http.client

conn = http.client.HTTPSConnection("apiconnect.angelone.in")
payload = "{\r\n    \"status\": [\r\n        \"NEW\",\r\n     \"CANCELLED\",\r\n        \"ACTIVE\",\r\n      \"SENTTOEXCHANGE\",\r\n        \"FORALL\"\r\n    ],\r\n    \"page\": 1,\r\n    \"count\": 10\r\n}"
headers = {
  'Authorization': 'Bearer AUTHORIZATION_TOKEN',
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'X-UserType': 'USER',
  'X-SourceID': 'WEB',
  'X-ClientLocalIP': 'CLIENT_LOCAL_IP',
  'X-ClientPublicIP': 'CLIENT_PUBLIC_IP',
  'X-MACAddress': 'MAC_ADDRESS',
  'X-PrivateKey': 'API_KEY'
}
conn.request("POST", "/rest/secure/angelbroking/gtt/v1/ruleList", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```

```java
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n  \"status\": [\r\n        \"NEW\",\r\n       \"CANCELLED\",\r\n        \"ACTIVE\",\r\n            \"SENTTOEXCHANGE\",\r\n        \"FORALL\"\r\n    ],\r\n    \"page\": 1,\r\n    \"count\": 10\r\n}");
Request request = new Request.Builder()
  .url("https://apiconnect.angelone.in/rest/secure/angelbroking/gtt/v1/ruleList")
  .method("POST", body)
  .addHeader("Authorization", "Bearer AUTHORIZATION_TOKEN")
  .addHeader("Content-Type", "application/json")
  .addHeader("Accept", "application/json")
  .addHeader("X-UserType", "USER")
  .addHeader("X-SourceID", "WEB")
  .addHeader("X-ClientLocalIP", "CLIENT_LOCAL_IP")
  .addHeader("X-ClientPublicIP", "CLIENT_PUBLIC_IP")
  .addHeader("X-MACAddress", "MAC_ADDRESS")
  .addHeader("X-PrivateKey", "API_KEY")
  .build();
Response response = client.newCall(request).execute();
```

```javascript
var axios = require('axios');
var data = JSON.stringify({"status":["NEW","CANCELLED","ACTIVE","SENTTOEXCHANGE","FORALL"],"page":1,"count":10});

var config = {
  method: 'post',
  url: 'https://apiconnect.angelone.in/rest/secure/angelbroking/gtt/v1/ruleList\n',
  headers: { 
    'Authorization': 'Bearer AUTHORIZATION_TOKEN', 
    'Content-Type': 'application/json', 
    'Accept': 'application/json', 
    'X-UserType': 'USER', 
    'X-SourceID': 'WEB', 
    'X-ClientLocalIP': 'CLIENT_LOCAL_IP', 
    'X-ClientPublicIP': 'CLIENT_PUBLIC_IP', 
    'X-MACAddress': 'MAC_ADDRESS', 
    'X-PrivateKey': 'API_KEY'
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
```

```r
library(httr)

url <- "https://apiconnect.angelone.in/rest/secure/angelbroking/gtt/v1/ruleList"
json_body <- jsonlite::toJSON(list(
    "status": [
        "NEW",
        "CANCELLED",
        "ACTIVE",
        "SENTTOEXCHANGE",
        "FORALL"
    ],
    "page": 1,
    "count": 10

))

response <- POST(url, 
    config = list(
    add_headers(
    'Authorization'= 'Bearer AUTHORIZATION_TOKEN',
    'Content-Type'= 'application/json',
    'Accept'= 'application/json',
    'X-UserType'= 'USER',
    'X-SourceID'= 'WEB',
    'X-ClientLocalIP'= 'CLIENT_LOCAL_IP',
    'X-ClientPublicIP'= 'CLIENT_PUBLIC_IP',
    'X-MACAddress'= 'MAC_ADDRESS',
    'X-PrivateKey'= 'API_KEY'
    ))
    ),
    body = json_body,
    encode = "raw"

print(response)
```

```go
package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://apiconnect.angelone.in/rest/secure/angelbroking/gtt/v1/ruleList%0A"
  method := "POST"

  payload := strings.NewReader({
    "status": [
        "NEW",
        "CANCELLED",
        "ACTIVE",
        "SENTTOEXCHANGE",
        "FORALL"
    ],
    "page": 1,
    "count": 10
})

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Authorization", "Bearer AUTHORIZATION_TOKEN")
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Accept", "application/json")
  req.Header.Add("X-UserType", "USER")
  req.Header.Add("X-SourceID", "WEB")
  req.Header.Add("X-ClientLocalIP", "CLIENT_LOCAL_IP")
  req.Header.Add("X-ClientPublicIP", "CLIENT_PUBLIC_IP")
  req.Header.Add("X-MACAddress", "MAC_ADDRESS")
  req.Header.Add("X-PrivateKey", "API_KEY")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
```

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

### POST /rest/secure/angelbroking/margin/v1/batch

Source: https://smartapi.angelbroking.com/docs/ResponseStructure

API documentation for the margin calculator batch endpoint, including request body, headers, and example.

```APIDOC
## [POST] /rest/secure/angelbroking/margin/v1/batch

### Description
Calculates margin requirements for a batch of positions.

### Method
POST

### Endpoint
https://apiconnect.angelone.in/rest/secure/angelbroking/margin/v1/batch

### Parameters
#### Request Body
- **positions** (array) - Required - List of positions for which margin is to be calculated.
  - **exchange** (string) - Required - Exchange code (e.g., NFO).
  - **qty** (integer) - Required - Quantity of the position.
  - **price** (number) - Required - Price of the position (0 if not applicable).
  - **productType** (string) - Required - Product type (e.g., INTRADAY).
  - **orderType** (string) - Required - Order type (e.g., LIMIT, MARKET).
  - **token** (string) - Required - Instrument token.
  - **tradeType** (string) - Required - Trade type (e.g., BUY, SELL).

#### Headers
- **X-PrivateKey** (string) - Required - API key.
- **Accept** (string) - Required - application/json.
- **X-SourceID** (string) - Required - Source identifier (e.g., WEB).
- **X-ClientLocalIP** (string) - Required - Client local IP address.
- **X-ClientPublicIP** (string) - Required - Client public IP address.
- **X-MACAddress** (string) - Required - Client MAC address.
- **X-UserType** (string) - Required - User type (e.g., USER).
- **Authorization** (string) - Required - Bearer token for authentication.
- **Content-Type** (string) - Required - application/json.

### Request Example
```json
{
  "positions": [
    {
      "exchange": "NFO",
      "qty": 50,
      "price": 0,
      "productType": "INTRADAY",
      "orderType": "LIMIT",
      "token": "67300",
      "tradeType": "BUY"
    },
    {
      "exchange": "NFO",
      "qty": 50,
      "price": 0,
      "productType": "INTRADAY",
      "orderType": "MARKET",
      "token": "67308",
      "tradeType": "SELL"
    }
  ]
}
```

### Response
#### Success Response (200)
- Response body contains margin calculation results (structure not specified in source).

#### Response Example
(Not provided in source)
```

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

### Python POST getLtpData with http.client

Source: https://smartapi.angelbroking.com/docs/WebSocket2

Python example using http.client to POST to the getLtpData endpoint. Requires a valid authorization token and API key.

```python
import http.client
import mimetypes
conn = http.client.HTTPSConnection(
    "apiconnect.angelone.in"
    )
payload = "{\n     \"exchange\": \"NSE\",\n     \"tradingsymbol\": \"SBIN-EQ\",\n     \"symboltoken\": \"3045\"\n}"
headers = {
  'Authorization': 'Bearer AUTHORIZATION_TOKEN',
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'X-UserType': 'USER',
  'X-SourceID': 'WEB',
  'X-ClientLocalIP': 'CLIENT_LOCAL_IP',
  'X-ClientPublicIP': 'CLIENT_PUBLIC_IP',
  'X-MACAddress': 'MAC_ADDRESS',
  'X-PrivateKey': 'API_KEY'
}
conn.request("POST", 
"/order-service/rest/secure/angelbroking/order/
v1/getLtpData", 
payload, 
headers)

res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
```

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

### Place Order API

Source: https://smartapi.angelbroking.com/docs/TopGainers

Documentation for the Place Order endpoint, including request/response structure and code examples in multiple languages.

```APIDOC
## POST /rest/secure/angelbroking/order/v1/placeOrder

### Description
Places an order for a trading symbol. Returns an order_id upon successful placement. The status of the order is not known at the moment of placing. Orders placed after market hours are treated as AMO orders. Market orders are converted into limit orders as per MPP limits. IOC orders are not allowed for commodities segment.

### Method
POST

### Endpoint
https://apiconnect.angelone.in/rest/secure/angelbroking/order/v1/placeOrder

### Headers
- **Authorization** (string) - Required - Bearer token for authentication.
- **Content-Type** (string) - Required - application/json
- **Accept** (string) - Required - application/json
- **X-UserType** (string) - Required - USER
- **X-SourceID** (string) - Required - WEB
- **X-ClientLocalIP** (string) - Required - Client local IP address.
- **X-ClientPublicIP** (string) - Required - Client public IP address.
- **X-MACAddress** (string) - Required - Client MAC address.
- **X-PrivateKey** (string) - Required - API key.

### Request Body
- **variety** (string) - Required - Order variety (e.g., NORMAL, STOPLOSS).
- **tradingsymbol** (string) - Required - Trading symbol (e.g., SBIN-EQ).
- **symboltoken** (string) - Optional - Symbol token (e.g., 3045).
- **transactiontype** (string) - Required - BUY or SELL.
- **exchange** (string) - Required - Exchange (e.g., NSE).
- **ordertype** (string) - Required - Order type (e.g., MARKET, LIMIT).
- **producttype** (string) - Required - Product type (e.g., INTRADAY, DELIVERY).
- **duration** (string) - Optional - Order duration (e.g., DAY).
- **price** (string) - Optional - Order price (e.g., 194.50).
- **squareoff** (string) - Optional - Square off value.
- **stoploss** (string) - Optional - Stop loss value.
- **quantity** (string) - Required - Order quantity.
- **scripconsent** (string) - Required - Consent for script (e.g., yes).
- **disclosedquantity** (number) - Optional - Disclosed quantity.

### Request Example
```json
{
  "variety": "NORMAL",
  "tradingsymbol": "SBIN-EQ",
  "symboltoken": "3045",
  "transactiontype": "BUY",
  "exchange": "NSE",
  "ordertype": "MARKET",
  "producttype": "INTRADAY",
  "duration": "DAY",
  "price": "194.50",
  "squareoff": "0",
  "stoploss": "0",
  "quantity": "1",
  "scripconsent": "yes"
}
```

### Response
#### Success Response (200)
- **status** (boolean) - Indicates success.
- **message** (string) - Response message.
- **errorcode** (string) - Error code if any.
- **data** (object) - Contains order details.
  - **script** (string) - Trading symbol.
  - **orderid** (string) - Order ID.
  - **uniqueorderid** (string) - Unique order ID.

#### Response Example
```json
{
  "status": true,
  "message": "SUCCESS",
  "errorcode": "",
  "data": {
    "script": "SBIN-EQ",
    "orderid": "200910000000111",
    "uniqueorderid": "34reqfachdfih"
  }
}
```
```

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

### Cancel Order with Axios (Node.js)

Source: https://smartapi.angelbroking.com/docs/TopGainers

Node.js example using axios to POST to the cancelOrder endpoint. Requires an authorization token and API key in headers.

```javascript
var axios = require('axios');
var data = JSON.stringify({
    "variety":"NORMAL",
    "orderid":"201020000000080"
});

var config = {
  method: 'post',
  url: 'https://apiconnect.angelone.in/rest/secure/angelbroking/order/v1/cancelOrder',
  headers: { 
    'Authorization': 'Bearer AUTHORIZATION_TOKEN', 
    'Content-Type': 'application/json', 
    'Accept': 'application/json', 
    'X-UserType': 'USER', 
    'X-SourceID': 'WEB', 
    'X-ClientLocalIP': 'CLIENT_LOCAL_IP', 
    'X-ClientPublicIP': 'CLIENT_PUBLIC_IP', 
    'X-MACAddress': 'MAC_ADDRESS', 
    'X-PrivateKey': 'API_KEY'
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});
```

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

### Cancel Order with httr (R)

Source: https://smartapi.angelbroking.com/docs/TopGainers

R example using httr to POST to the cancelOrder endpoint. Uses jsonlite to build the JSON body.

```r
library(httr)

url <- "https://apiconnect.angelone.in/rest/secure/angelbroking/order/v1/cancelOrder"
json_body <- jsonlite::toJSON(list(
    "variety":"NORMAL",
    "orderid":"201020000000080"
    ))

response <- POST(url, 
    config = list(
    add_headers(
    'Authorization'= 'Bearer AUTHORIZATION_TOKEN',
    'Content-Type'= 'application/json',
    'Accept'= 'application/json',
    'X-UserType'= 'USER',
    'X-SourceID'= 'WEB',
    'X-ClientLocalIP'= 'CLIENT_LOCAL_IP',
    'X-ClientPublicIP'= 'CLIENT_PUBLIC_IP',
    'X-MACAddress'= 'MAC_ADDRESS',
    'X-PrivateKey'= 'API_KEY'
    ))
    ),
    body = json_body,
    encode = "raw"

print(response)
```
Tokens:
Raw