---
title: "Place Trade"
method: POST
path: "/trading/orders"
tags: ["Trading"]
---

# Place Trade

`POST /trading/orders`

Place a buy or sell order using a specific account and connector.

Args:
    trade_request: Trading request with account, connector, trading pair, type, amount, etc.
    accounts_service: Injected accounts service

Returns:
    TradeResponse with order ID and trading details

Raises:
    HTTPException: 400 for invalid parameters, 404 for account/connector not found, 500 for trade execution errors

## Request body

- TradeRequest — Request model for placing trades
  - `account_name` string, required — Name of the account to trade with
  - `connector_name` string, required — Name of the connector/exchange
  - `trading_pair` string, required — Trading pair (e.g., BTC-USDT)
  - `trade_type` 'BUY' | 'SELL', required — Whether to buy or sell
  - `amount` union, required — Amount to trade
    - number
    - string
  - `order_type` 'LIMIT' | 'MARKET' | 'LIMIT_MAKER' — Type of order
  - `price` union — Price for limit orders
    - number
    - string
  - `position_action` 'OPEN' | 'CLOSE' — Position action for perpetual contracts (OPEN/CLOSE)

## Response `201`

Successful Response

- TradeResponse — Response model for trade execution
  - `order_id` string, required — Client order ID assigned by the connector
  - `account_name` string, required — Account used for the trade
  - `connector_name` string, required — Connector used for the trade
  - `trading_pair` string, required — Trading pair
  - `trade_type` string, required — Trade type
  - `amount` string, required — Trade amount
  - `order_type` string, required — Order type
  - `price` string, nullable, required — Order price
  - `status` string — Order status

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/hummingbot/apis/hummingbot-api.md) · [All operations](https://skmtc.net/hummingbot/apis/hummingbot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hummingbot/hummingbot-api/versions/5347fe79537f/schema)