Static IP for ICICI Direct Breeze API
ICICI Direct accepts Breeze API orders only from the static IP registered with your API key. A primary IP is mandatory and a secondary is optional, and you can change the IP once a calendar week. ICICI hasn't said whether it accepts IPv6, so use an IPv4 address.
What ICICI checks
- Orders from the registered IP. ICICI's FAQ says a static IP is mandatory for Breeze API access.
- Since 1 October 2025. ICICI's FAQ gives this date and says all existing API keys were deleted, so older keys need replacing.
- Primary and secondary. Primary is mandatory; secondary is an optional backup.
- Weekly changes. Once per calendar week. For urgent exceptions, ICICI points to breezeapi@icicisecurities.com.
- No header. ICICI checks the address your request comes from; you don't send the IP.
- Family. SEBI-defined family (spouse, dependent parents, dependent children) can share an IP, after ICICI verifies the accounts.
How to register your IP
- Get a dedicated IPv4 with its proxy details.
- Check the exit address:
curl -x http://USER:PASS@HOST:PORT https://ifconfig.co - On the Breeze API portal, register an app with the address as the Primary IP. To change it later, open View Apps and edit the IP.
Send Breeze orders through the fixed IP
The official breeze-connect client has no proxy argument but uses requests, which reads the proxy variables. Set them before importing:
import os
PROXY = os.environ["PROXY_URL"] # http://USER:PASS@HOST:PORT
for v in ("HTTPS_PROXY", "HTTP_PROXY"):
os.environ[v] = PROXY
from breeze_connect import BreezeConnect
breeze = BreezeConnect(api_key=os.environ["BREEZE_API_KEY"])
breeze.generate_session(api_secret=os.environ["BREEZE_API_SECRET"], session_token=os.environ["BREEZE_SESSION_TOKEN"])
The full Breeze proxy guide on GitHub has an order example, streaming and troubleshooting.
Common Breeze problems
- Orders rejected, other calls fine. The order left from another IP. Print the exit IP from inside the bot.
- Old API key stopped working. ICICI deleted pre-rule keys. Create a new one with your IP.
- Proxy can leave over IPv6. The Breeze API host has an IPv6 address and ICICI hasn't said it accepts IPv6. Use an IPv4-only exit.
Breeze static IP: FAQs
Does ICICI Breeze accept IPv6?
ICICI hasn't said. Its FAQ only asks for the public IP you access Breeze from. Use a dedicated IPv4 to be safe.
How often can I change my Breeze static IP?
Once per calendar week, from View Apps on the Breeze portal.
Can family members share a static IP on ICICI Direct?
Yes, if they fall under SEBI's family definition. ICICI verifies whether the accounts qualify.
Sources
- ICICI Direct FAQ: is a static IP mandatory?
- ICICI Direct FAQ: creating an API key after the circular
- ICICI Direct FAQ: changing your static IP
- ICICI Direct FAQ: family members sharing an IP
- Breeze Python SDK
Get your dedicated static IP
IPv6 ₹50 a month, IPv4 ₹200 a month, plus GST. Live in minutes, whitelisted once.