# Execute trade

Source: https://docs.tradeit.app/api/execute-trade

`POST /api/tool/execute`

Submits a previously created trade draft to the selected brokerage.

**OAuth scopes:** `trade:write`, `tool:execute`

**Plan:** Trade It Pro

**Returns:** [Trade](/models/trade)

## Request body [#request-body]

- **`tool_name`** · `string` · required

Selects this API operation.

Allowed values: `execute_trade`.

- **`params`** · `object` · required

Parameters for this operation.

- **`params.trade_id`** · `number | string` · required

ID of the draft trade to execute, as returned by create_trade or create_options_trade.

## Example request [#example-request]

```bash
curl https://api.tradeit.app/api/tool/execute \
  --request POST \
  --header "Authorization: Bearer $TRADE_IT_ACCESS_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "tool_name": "execute_trade",
    "params": {
      "trade_id": 842
    }
  }'
```

## Example response [#example-response]

### `200 OK` [#_200-ok]

```json
{
  "id": 842,
  "created_at": "2026-03-17T14:14:31.112Z",
  "updated_at": "2026-03-17T14:21:54.937Z",
  "user_id": 1,
  "asset_id": 88,
  "account_id": 304,
  "source": null,
  "image_url": null,
  "external_id": "114",
  "type": 0,
  "action": "buy",
  "direction": null,
  "total_units": 4,
  "filled_units": 0,
  "canceled_units": 0,
  "notional_amount": { "amount": 1000, "currency": "USD" },
  "execution_price": null,
  "status": "placed",
  "order_type": "limit",
  "limit_price": { "amount": 250, "currency": "USD" },
  "stop_price": null,
  "time_in_force": "day",
  "placed_at": "2026-03-17T14:21:54.937Z",
  "executed_at": null,
  "error_message": null,
  "fee": null,
  "legs": null,
  "event": null,
  "analysis": null
}
```

> **Note**
>
> A successful request means the order was accepted for processing; it does not necessarily mean it has filled.

Inspect `status`, `filled_units`, `executed_at`, and `error_message`, then use `get_trades` with `refresh: true` when current brokerage state is required.