IQ Option · Python · 2026

If you’re looking for how to use the iqoptionapi Python library — especially the check_win_v4 method to read a trade’s result — this is the practical reference. See how to connect, read candles, place orders and capture the profit, with a ready example and a free open-source bot that already does it all.

🤖 Get the free bot (IQ Option + Quotex)

Open-source bot with 9 strategies. Edit it by chatting with ChatGPT/Claude — no coding.

Get the bot →

Is there an official IQ Option API?

No. IQ Option has no official public API. The community uses the open-source iqoptionapi library, which talks to the same WebSocket the platform uses. Because it’s unofficial, it can change without notice.

Use a demo (practice) account first. Automation on a real account carries ban risk — test thoroughly before.

Connect with Python — minimal example

# pip install iqoptionapi from iqoptionapi.stable_api import IQ_Option import time api = IQ_Option(“you@email.com”, “yourpass”) api.connect() api.change_balance(“PRACTICE”) # always demo first candles = api.get_candles(“EURUSD”, 60, 100, time.time()) ok, order_id = api.buy(1, “EURUSD”, “call”, 1) # 1 = 1 min profit = api.check_win_v4(order_id) # trade result

check_win_v4: how to read the order result

check_win_v4 is, on the current library, the most reliable way to know whether an order won or lost. It returns the profit of the trade: positive = win, negative = loss, zero = tie (refund). Unlike older versions (check_win, check_win_v2/v3), v4 handles today’s contract types better.

Call check_win_v4 with the order_id returned by buy(). It blocks until expiry — in multi-asset bots, run each trade asynchronously or in threads so it doesn’t freeze the main loop.

Most-used iqoptionapi methods

  • connect() / change_balance("PRACTICE"|"REAL") — connection and account type
  • get_candles(asset, size, count, end) — candle history
  • buy(amount, asset, "call"|"put", expiry_min) — binary/turbo option
  • check_win_v4(order_id) — order result (profit)
  • get_balance() / get_all_profit() — balance and payout

Skip the hard part: use the ready-made bot

Turning the raw API into a safe strategy (signals, payout filter, daily stop loss, risk control) is the real work. The IaTraderPro Bot already does it: it uses iqoptionapi, ships 9 ready strategies and a visual browser dashboard, and is open source — you read and change the code by chatting with ChatGPT or Claude.

See also: Python + IQ Option API (unofficial): step-by-step guide.

FAQ

What does check_win_v4 return? The trade profit (positive = win, negative = loss).

Is it official? No — community library. Test on demo first.

Can my account be banned? Automation carries risk on real accounts; read the broker terms.

Does it work for Quotex too? Yes, the bot has a Quotex version.

⚠️ Binary options involve high risk and can result in total loss of capital. Educational content, not investment advice. No bot or strategy guarantees profit. Always test on a demo account.