Binomo API for Python

Build your own Binomo trading bot in Python. BinomoAPI handles login, sessions, the WebSocket connection and trade payloads, so you can work on your strategy.

Get started in 5 minutes Join the Discord Star on GitHub

---

Install

pip install BinomoAPI

Your first trade

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}")

        # "EURO" is the RIC code for EUR/USD; see the asset list
        trade = await api.place_call_option(asset="EURO", duration_seconds=60, amount=100)
        print(trade)

asyncio.run(main())

That’s the whole loop: log in, open a client, check the balance, trade. Everything runs on your demo account until you pass demo=False.

What you can do with it

Authenticate	Email/password login with the session kept alive for later requests.
Read balances	Demo and real account balances, cached for 5 minutes to avoid extra requests.
Discover assets	52 bundled assets (forex, OTC, crypto, stocks, indices, metals), each with its RIC code. No login needed.
Trade binary options	CALL (up) and PUT (down) turbo options over Binomo’s WebSocket API.
Handle errors cleanly	A small exception hierarchy: AuthenticationError, TradeError and more.
Use modern Python	async/await, type hints, dataclass models and async context managers.

Where to go next

• New here? Start with Getting Started: install, log in and place a demo trade.
• Building a bot? Read Trading to learn how expiry times work, then grab code from Examples.
• Need an asset code? The Asset List has every supported asset and its RIC.
• Looking up a method? See the API Reference.
• Something broke? Try the FAQ and Error Handling, or ask on Discord.

Join the community

BinomoAPI is built in the open by ChipaDevTeam. Traders and developers share strategies, bots and fixes in our community:

• 💬 Discord: get help, show off your bot, follow releases
• ✈️ Telegram: talk to the team directly
• ⭐ GitHub: star the repo, report issues, send pull requests

More ways to get involved are on the Community page, including a bot built for you by the team.

BinomoAPI is an unofficial library and is not affiliated with Binomo. Binary options are high-risk and you can lose your whole stake. Test on a demo account first, and only trade money you can afford to lose.