Check whether Darwin's local trading and historical-data ports are reachable. Call this first if any other tool fails: it distinguishes "Darwin is not running" from "Darwin refused the command", and needs only Darwin running and listening, not the account logged in.

darwin.state is running, starting or stopped, and darwin.hint says what to do about it. This is also the tool to poll after start_darwin, once the user says they have finished the login.

Launch dGO, Directa's launcher, so the user can bring Darwin up. Needs the server to have been started with DIRECTA_AUTOSTART=true.

This does not finish the job and does not wait: Darwin requires an OTP, so the call returns as soon as dGO is running and the user takes it from there. Tell them to complete the login (and, if dGO stops on its tile grid rather than opening Darwin, that AutoSelezione must be set to "Darwin 2" in dGO's Preferenze), then call check_connection to see whether the ports have opened. Do not call this repeatedly while waiting — Directa allows one session at a time, and a second dGO can disturb the login in progress.

Since it puts a window and an OTP prompt in front of the user, never call it on your own initiative to repair a failed tool: propose it and let the user ask for it.

Get Darwin's connection status, release, and whether the real-time datafeed is enabled. Richer than check_connection since it goes through the dAPI conversation rather than a raw TCP probe. The datafeed_enabled field tells you in advance whether the historical tools can work at all.

Get raw account figures from dAPI INFOACCOUNT: liquidity, equity and two fields whose documented names do not match their contents.

gain_euro is the open P&L, and open_profit_loss is the portfolio's cost basis, not a profit — both verified by reconciliation. Do not quote open_profit_loss as a gain. For anything about portfolio value or performance prefer get_portfolio_overview, which derives the figures and checks them; use this tool for liquidity, equity, the account code, or when the user wants the raw line.

Get buying power: cash available for stocks and derivatives, with and without margin (dAPI INFOAVAILABILITY). Use this rather than get_account_balance when the question is "how much can I invest".

Get every open position in the portfolio, with quantity, average price and theoretical gain. Returns the complete list.

The whole picture in one call: every position with its current price and value, plus portfolio totals and P&L. Prefer this over get_positions when the question is about how the portfolio is doing or what it is worth.

Darwin does not report a current price, so price and value are derived from the average price and the theoretical gain. Do not compute values yourself from get_positions: bonds (symbols starting M.) are quoted as a percentage of nominal, so quantity times price overstates them 100-fold. This tool handles that and then checks its own arithmetic against Darwin's reported figures — if reconciliation.reconciled is False, say so and quote the residual rather than presenting the totals as fact.

Get a single position by symbol, as it appears in get_positions.

Get orders placed today with their state — "In negoziazione" (working), "Eseguito" (filled), "Revocato" (cancelled), and so on.

A symbol usually carries several order records with different states, so read the status field before describing an order as open; set pending_only=True for just the ones still working.

Ask Darwin what an order would cost, without placing it. Use this before place_limit_order, and whenever the user asks about commissions.

The order is submitted and deliberately left unconfirmed, so it never reaches the market, and Darwin answers with its pre-trade disclosure: the instrument's full name, the amount, the commission that would apply, and any conflict-of-interest note. This is the only way to obtain commission figures — no dAPI command reports them, and they depend on the order's value, so they cannot be looked up in advance.

Read on_market in the response before describing the outcome. It should be false. If it is true, Darwin was not configured to ask for confirmation and the order IS live — say so immediately and prominently.

Subject to the same DIRECTA_ENABLE_ORDERS gate as place_limit_order, since this does send an order command to a real account.

Place a REAL limit order with real money. There is no simulation mode. Disabled unless the server runs with DIRECTA_ENABLE_ORDERS=true.

Prefer preview_limit_order first: it reports the commission and the exact instrument Darwin matched, without placing anything.

Darwin requires a two-step submit-then-confirm exchange, and both steps happen inside this one call because a pending confirmation does not survive the connection that produced it. Read on_market in the response to know whether the order is actually working — an exchange that completes without error has still placed nothing if confirmation did not go through. Then verify with get_orders rather than trusting the acknowledgement.

order_id is the client-side reference Darwin echoes back; one is generated if omitted.

Change the limit price of an open order (signal_price applies only to stop orders). Confirms in the same exchange, like place_limit_order, and reports on_market. Same order gate.

Cancel one open order by the order_id shown in get_orders. Same order gate as place_limit_order.

Cancel every open order for a symbol. Confirm the symbol with the user first — this affects orders the user may not have asked about. Same order gate as place_limit_order.

Get daily OHLC candles for the last N days. Needs the real-time quote entitlement — without it this fails with code 1032.

Get intraday OHLC candles bucketed by period_minutes over the last N days. Needs the real-time quote entitlement (code 1032 without it).

Get OHLC candles within an explicit range. Dates as YYYYMMDDHHMMSS (e.g. 20260810093000); period_seconds sets the bucket (60=1min, 300=5min, 3600=1hr, 86400=1day). Needs the real-time quote entitlement.

Get tick-by-tick trades over the last N days. Can be very large — prefer get_intraday_candles beyond a single session. Needs the real-time quote entitlement.