Create an Order for an Account.

post

https://broker-api.sandbox.alpaca.markets/v1/trading/accounts/{account_id}/orders

Creating an order for your end customer. Each trading request must pass in the account_id in the URL.

Note that when submitting crypto orders, Market, Limit and Stop Limit orders are supported while the supported time_in_force values are gtc, and ioc. We accept fractional orders as well with either notional or qty provided.

Path Params

account_id

uuid

required

Account identifier.

Body Params

symbol

string

required

Symbol or asset ID to identify the asset to trade

qty

string

Number of shares to trade. Can be fractionable for only market and day order types.

notional

string

Dollar amount to trade. Cannot work with qty. Can only work for market order types and time_in_force = day.

side

string

enum

required

Represents what side of the transaction an order was on.

type

string

enum

required

Allowed:

time_in_force

string

enum

required

Allowed:

limit_price

string

Required if type is limit or stop_limit

stop_price

string

Required if type is stop or stop_limit

trail_price

string

If type is trailing_stop, then one of trail_price or trail_percent is required

trail_percent

string

If type is trailing_stop, then one of trail_price or trail_percent is required

extended_hours

boolean

Defaults to false. If true, order will be eligible to execute in premarket/afterhours. Only works with type limit and time_in_force = day.

client_order_id

string

length ≤ 48

A unique identifier for the order. Automatically generated if not sent. (<= 48 characters)

order_class

string

enum

Allowed:

take_profit

object

Takes in a string/number value for limit_price

stop_loss

object

Takes in a string/number values for stop_price and limit_price

commission

string

The commission you want to collect from the user.

commission_bps

string

The percent commission you want to charge the end user on the order (expressed in bps). Alpaca will convert the order to a notional amount for purposes of calculating commission

source

string

instructions

string

subtag

string

swap_fee_bps

string

Responses

422

Some parameters are not valid

Language

Credentials

Basic

base64

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK

400Malformed input.

403Request is forbidden

404Resource does not exist.