---
title: "Create Trade"
method: POST
path: "/api/trades"
tags: ["trades", "trades"]
---

# Create Trade

`POST /api/trades`

## Request

- Base URL: `https://marketcrew.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://marketcrew.ai/api/trades`
- Auth: HTTP bearer

Create a new trade

## Request body

- TradeCreate: Trade creation model
  - `portfolio_id` string, uuid, required
  - `financial_instrument_id` string, uuid, required
  - `trade_type` 'buy' | 'sell', required: Trade types
  - `quantity` number, required
  - `price` number, required
  - `trade_date` string, date, required
  - `notes` string, nullable
  - `source` 'manual' | 'order' | 'smart_alert' | 'migration': Trade source types
  - `source_id` string, uuid, nullable

## Response `200`

Successful Response

- APIResponse: Generic API response model
  - `success` boolean, required
  - `message` string, required
  - `data` object, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/marketcrew/apis/cappilot.md) · [All operations](https://skmtc.dev/marketcrew/apis/cappilot/llms.txt) · [OpenAPI document](https://skmtc.dev/marketcrew/apis/cappilot/revisions/7036e9c74d40?raw)