TDS (Tax Deducted at Source)

Get the cumulative TDS deducted on your trades for the current Indian financial year.

HTTP

Method	GET
Endpoint	/trade/api/v2/tds
Rate limit	25 requests per 10 seconds

Request Parameters

None.

Example

Python

import requests

headers, path = sign_request("GET", "/trade/api/v2/tds")
response = requests.get(BASE_URL + path, headers=headers)
print(response.json())

Java

HttpResponse<String> resp = client.send(
    "GET", "/trade/api/v2/tds", null, null);
System.out.println(resp.body());

Go

headers, p, err := SignRequest("GET", "/trade/api/v2/tds", nil)
if err != nil { panic(err) }

req, _ := http.NewRequest("GET", BaseURL+p, nil)
for k, v := range headers { req.Header.Set(k, v) }
resp, err := http.DefaultClient.Do(req)
if err != nil { panic(err) }
defer resp.Body.Close()
out, _ := io.ReadAll(resp.Body)
fmt.Println(string(out))

Node.js

const {signRequest, BASE_URL} = require('./reference-client');

const {headers, path} = signRequest('GET', '/trade/api/v2/tds');
const r = await fetch(BASE_URL + path, {
  method: 'GET',
  headers,
});
console.log(await r.json());

Response

{
  "data": {
    "total_tds_amount": 459.12,
    "financial_year": "2024-2025"
  }
}

Response Parameters

Field	Type	Description
total_tds_amount	number	Cumulative TDS in INR for the financial year.
financial_year	string	Indian financial year (April–March), e.g. "2024-2025".

note

TDS from C2C orders is recorded with a delay of 1 day. If you've recently traded C2C, expect today's number to update tomorrow.