Documentation

Getting Started with Trading

We tried our best to make the trading API as easy as possible to work with. There are some essential concepts to understand having to do with a trading flow, but the calls themselves are very straightforward.

Buying and Selling Equities

Placing an order through the Trading API is very simple. There's no FIXML to learn, no custom formats or XML. There are five required parameters:

  • class - The kind of order to be placed. One of: equity, option, multileg, combo.
  • symbol - The symbol to be ordered.
  • duration - The time for which the order will be remain in effect (Day or GTC).
  • side - The side of the order (buy or sell).
  • quantity - The number of shares ordered.
  • type - The type of order to be placed (market, limit, etc.)

A properly composed order for 100 shares of AAPL looks like this:

POST /v1/accounts/12345678/orders HTTP/1.1
Host: api.tradier.com
Accept: */*

class=equity&symbol=AAPL&duration=day&side=buy&quantity=100&type=market

Buying and Selling Options

Placing an order for an option is very similar to that of a stock. There is only one additional field for placing a single-leg

  • option_symbol an OCC symbol (AAPL140118C00195000) for the option to be ordered.

A properly composed order for 100 shares of an AAPL option looks like this:

POST /v1/accounts/12345678/orders HTTP/1.1
Host: api.tradier.com
Accept: */*

class=option&symbol=AAPL&duration=day&side=sell_to_open&quantity=100&type=market&option_symbol=AAPL140118C00195000

Placing Multileg and Combo orders

Placing multileg and combo orders uses the same framework and parameters as explained above for single leg orders with only slight modification. Legs only have a three specific data points: side, quantity, and symbol. For option legs you should send option_symbol, in the instance of combo orders, equity legs should have option_symbol set to null as the underlying symbol will be used.

In order to send multiple legs, we've adopted standard form-parameter notation: side[index], quantity[index], option_symbol[index], where index is the leg number (based at zero).

  • side[index] the side of the leg.
  • quantity[index] the quantity of shares/contracts for that leg
  • option_symbol[index] the OCC symbol (AAPL140118C00195000) for the option. Should be null for equity legs.

A properly composed multileg order (spread) looks like this:

POST /v1/accounts/12345678/orders HTTP/1.1
Host: api.tradier.com
Accept: */*

class=multileg&symbol=CSCO&duration=day&type=market
  &side[0]=buy_to_open&quantity[0]=1&option_symbol[0]=CSCO150117C00035000
  &side[1]=sell_to_open&quantity[1]=1&option_symbol[1]=CSCO140118C00008000

Previewing Orders

It is in the investor's best interest to preview an order before actually placing it. A preview call will return issues and warnings associated with the order (if applicable) as well as commission information should the order be executed. Previewing is also the best way to get started using the Trading API.

By sending preview=true as a parameter to the Create Order call, you can place "pretend" calls to these APIs.

Note: Preview orders are not required — but are recommended. There will be circumstances (i.e. algorithmic trading) where it is unreasonable to preview the order first.

Market Data

Market data is key to placing accurate trades. As a developer, you're responsible for making market data requests in order to give users enough information before placing a trade.


Tradier Inc. and its corresponding technology services (including API services) are distinct and separate from the services provided by Tradier Brokerage Inc. For more information regarding the services of Tradier, Inc., please contact techsupport@tradier.com. For more information regarding the services of Tradier Brokerage, Inc. please contact service@tradierbrokerage.com. Tradier Brokerage Inc. Member FINRA/SIPC

© 2017 Tradier Inc.
  • 11016 Rushmore Drive, Suite 350
  • Charlotte, NC 28277

All materials contained on this site and specifically the API documentation pages are protected by United States copyright law and may not be copied, reproduced, distributed, transmitted, displayed, published or broadcast without the prior written permission of Tradier Inc. The Structure, Format, Layout, Examples and Design of the pages are owned by Tradier Inc, and any efforts to willfully or accidently duplicate a whole or part of the pages on this site is a violation of United States copyright law.