Build your own Binomo trading bot in Python. Log in, read your demo or real balance, list every asset and RIC code, and place CALL/PUT binary options in a few lines of async code.
Documentation · Getting Started · Examples · Asset List · Discord
📈 Trading crypto too? ChipaX is our own perpetuals exchange, and it has a Python API.
pip install chipaxgives you perps on real Hyperliquid liquidity, plus a free $100,000 paper account that charges the same fees and enforces the same leverage caps as live trading. No deposit or KYC to practise. → chipax-python
Binomo has no public trading API. BinomoAPI is a free, open-source Python library that talks to the same endpoints the Binomo web app uses, so you can automate your strategy without browser automation.
- ⚡ Async and fast: built on
asyncioand WebSockets - 🔐 Login and sessions handled: email/password sign-in, with the authenticated session reused for later requests
- 💰 Demo and real accounts: switch with one flag, or per trade
- 📊 52 bundled assets: forex, 24/7 OTC pairs, crypto, indices, stocks, gold and silver, with their RIC codes
- 🧱 Typed and tidy: dataclass models, type hints and a clear exception hierarchy
- 🆓 MIT licensed: use it in personal or commercial projects
pip install BinomoAPIRequires Python 3.8+.
import asyncio
import os
from BinomoAPI import BinomoAPI
async def main():
login = BinomoAPI.login(os.environ["BINOMO_EMAIL"], os.environ["BINOMO_PASSWORD"])
async with BinomoAPI.create_from_login(login, demo=True) as api:
balance = await api.get_balance()
print(f"Demo balance: {balance.amount:.2f} {balance.currency}")
trade = await api.place_call_option(
asset="Z-EUR/USD", # RIC code for EUR/USD (OTC), open 24/7
duration_seconds=60,
amount=100, # stake in minor units: 100 = 1.00
)
print(trade) # {'status': 'submitted', 'asset': 'Z-EUR/USD', 'direction': 'call', ...}
asyncio.run(main())👉 New to BinomoAPI? The Getting Started guide walks you from install to first trade in five minutes.
from BinomoAPI import BinomoAPI
for asset in BinomoAPI.get_assets():
print(asset.name.strip(), asset.ric, "OTC" if asset.is_otc else "")
BinomoAPI.get_otc_assets() # 24/7 OTC assets only
BinomoAPI.get_standard_assets() # market-hours assets onlyTrades take the RIC code ("EURO" for EUR/USD, "XBT/USD" for Bitcoin), not the display name. See the full asset list.
demo = await api.get_balance("demo")
real = await api.get_balance("real")
print(demo.amount, real.amount)await api.place_call_option("EURO", duration_seconds=60, amount=100)
await api.place_put_option("EURO", duration_seconds=300, amount=100, use_demo=False) # real accountExpiry times snap to clock boundaries, just as they do in the Binomo app. Learn how expiry is calculated.
from BinomoAPI import AuthenticationError, InvalidParameterError, TradeError, BinomoAPIException
try:
await api.place_call_option("EURO", 60, 100)
except InvalidParameterError as e:
print("Fix your input:", e)
except TradeError as e:
print("Order failed:", e)
except BinomoAPIException as e:
print("API error:", e)More in the docs: Trading · Examples · API Reference · Error Handling · Configuration · FAQ
| Example | What it shows |
|---|---|
| Trade every minute | Align orders to Binomo's expiry boundaries |
| Signal bot with risk limits | Plug in your strategy, with stake, trade-count and balance stops |
| Multiple assets | One client, several pairs |
examples/place_order.py |
Runnable script that also prints the server's replies |
Join traders and developers building Binomo bots with BinomoAPI:
- 💬 Discord: help, strategies, release news
✈️ Telegram: talk to the team- 🐛 Issues: bugs and feature requests
- ⭐ Star this repo so other traders can find it
ChipaDevTeam builds trading bots around your strategy. Get our services.
- 🚀 ChipaEditor: AI-powered strategy editor
- 📈 ChipaX: perpetuals exchange with a Python SDK and a free $100k paper account
BinomoAPI is free. If it saves you time, you can help keep it maintained: Patreon · PayPal
Pull requests are welcome, whether new assets, examples, fixes or docs. See the contributing guide.
Inspired by hert0t/Binomo-API.
MIT © ChipaDevTeam
BinomoAPI is an unofficial project and is not affiliated with, endorsed by or connected to Binomo. Binary options trading carries a high risk of losing your entire stake. This software is provided for educational and research purposes, without warranty. Test on a demo account, check that automated trading is allowed under Binomo's terms and your local laws, and never trade money you can't afford to lose.