Skip to content
Logo

Errors

A failed tool call comes back as an MCP tool result with isError: true and a JSON body:

{ "error": "missing_scope", "message": "…", "scope": "orders:create" }

error is a stable code. message is written for the agent to read and relay. Intelligence tools report missing data differently, with ok: false.

Connection

unauthenticated

The access token is missing, invalid or expired. Reconnect Orus from your AI client.

missing_scope

The connection does not hold the scope this tool needs. The body names it in scope. Reconnect and approve a request that includes it. See Permissions.

grant_revoked

The connection was revoked in the Farao app, or no longer exists. Reconnect to use Orus again.

agent_expired

The trading session behind this connection has expired. Reads still work but orders cannot be placed. Approve the connection again from the Farao app.

agent_not_configured

The connection has no trading session bound to it. Approve the connection again from the Farao app.

Trading

risk_rejected

The order broke a rule. The body has a code for the rule, a message and often details with the numbers involved.

{
  "error": "risk_rejected",
  "code": "asset_blocked",
  "message": "…",
  "details": { }
}

At the prepare step it is a market rule: notional under the minimum, slippage over 10%, leverage over the market maximum, a stop loss past liquidation, or a trigger on the wrong side of the price. With marginUsd it can also be margin_too_small: the market's smallest order does not fit the margin even at the highest leverage allowed, and details.minMarginUsd is the smallest margin that works. Giving both size and marginUsd, or neither, is size_or_margin. At execution on an autonomous connection it is one of your limits: per trade, max leverage, daily cap or a blocked asset.

The agent should read the details and adjust. Retrying the same order will fail the same way.

approval_required

The agent called confirm_prepared_action on a manual connection. Only you can execute the trade, with the Approve button on its card. The prepared trade is still valid. See Manual mode.

no_position

A close or a take profit and stop loss change named a market where you have no open position.

prepared_action_not_found

No prepared trade with that id exists for this connection.

prepared_action_expired

More than 1 hour passed since the trade was prepared. Prepare it again, since the price has moved anyway.

prepared_action_already_resolved

The prepared trade was already declined, or is being executed by another call.

Upstream

upstream_error

Hyperliquid or a Farao service did not answer. Nothing was changed. Try again shortly.