Documentation

Get a user's orders

Get order status information for each of a user's accounts. The order information is identical to a request made against the accounts/orders call. This call should be used when information is required across multiple accounts, as opposed to making multiple account-based calls.

Endpoint

Method
GET
URL
/v1/user/orders

Headers

Accept
application/xml, application/json, application/javascript
Default: application/xml
Required: false
Authorization
Bearer {access token}
Required: true

Response

Field Description
id Order number
type Order type (market, limit, stop, stop_limit or market, credit, debit, even)
class Classification of order (equity, option, multileg, combo)
symbol Symbol
side The side of the order (buy, buy_to_open, buy_to_cover, buy_to_close, sell, sell_short, sell_to_open, sell_to_close
quantity Quantity
status Status of the order (filled, canceled, open, expired, rejected, pending, partially_filled, submitted)
duration Duration of the order (day, gtc)
price Price
option_type Option Type (put, call)
expiration_date Option expiration date
exch Exchange
avg_fill_price Average fill price
exec_quantity Quantity executed
exec_exch Execution exchange
last_price Last price
last_quantity Last quantity
remaining_quantity Remaining quantity
stop_price Stop Price
num_legs The number of legs
strategy The option strategy for multileg orders

Example

Command

$ curl -H "Authorization: Bearer {accesstoken}" https://api.tradier.com/v1/user/orders

Request

GET /v1/user/orders HTTP/1.1
Host: api.tradier.com
Accept: application/xml
Authorization: Bearer 098f6bcd4621d373cade4e832627b4f6
Content-Type: application/x-www-form-urlencoded
User-Agent: curl/7.24.0 (x86_64-apple-darwin12.0) libcurl/7.24.0 OpenSSL/0.9.8r zlib/1.2.5

Response

HTTP/1.1 200 OK
Content-Type: application/xml;charset=utf-8
X-Ratelimit-Allowed: 120
X-Ratelimit-Used: 1
X-Ratelimit-Available: 119
X-Ratelimit-Expiry: 1369164360001

<?xml version="1.0" encoding="UTF-8"?>
<accounts>
  <account>
    <account_number>12345678</account_number>
    <orders>
      <order>
        <id>5751</id>
        <type>limit</type>
        <symbol>F</symbol>
        <side>sell_short</side>
        <quantity>1.00000</quantity>
        <status>pending</status>
        <duration>day</duration>
        <price>21.16000</price>
        <avg_fill_price>0.00000</avg_fill_price>
        <exec_quantity>0.00000</exec_quantity>
        <last_fill_price>0.00000</last_fill_price>
        <last_fill_quantity>0.00000</last_fill_quantity>
        <remaining_quantity>0.00000</remaining_quantity>
        <create_date>2014-05-28T12:04:52.627Z</create_date>
        <transaction_date>2014-05-28T12:04:52.627Z</transaction_date>
        <class>equity</class>
      </order>
      <order>
        <id>5776</id>
        <type>market</type>
        <symbol>F</symbol>
        <side>buy</side>
        <quantity>0.00000</quantity>
        <status>pending</status>
        <duration>day</duration>
        <avg_fill_price>0.00000</avg_fill_price>
        <exec_quantity>0.00000</exec_quantity>
        <last_fill_price>0.00000</last_fill_price>
        <last_fill_quantity>0.00000</last_fill_quantity>
        <remaining_quantity>0.00000</remaining_quantity>
        <create_date>2014-05-28T12:05:51.673Z</create_date>
        <transaction_date>2014-05-28T12:05:51.673Z</transaction_date>
        <class>combo</class>
        <num_legs>2</num_legs>
        <leg>
          <type>market</type>
          <symbol>F</symbol>
          <side>buy</side>
          <quantity>100.00000</quantity>
          <status>pending</status>
          <duration>day</duration>
          <avg_fill_price>0.00000</avg_fill_price>
          <exec_quantity>0.00000</exec_quantity>
          <last_fill_price>0.00000</last_fill_price>
          <last_fill_quantity>0.00000</last_fill_quantity>
          <remaining_quantity>0.00000</remaining_quantity>
          <create_date>2014-05-28T12:05:51.660Z</create_date>
          <transaction_date>2014-05-28T12:05:51.660Z</transaction_date>
        </leg>
        <leg>
          <type>market</type>
          <symbol>F</symbol>
          <side>sell_to_open</side>
          <quantity>1.00000</quantity>
          <status>pending</status>
          <duration>day</duration>
          <avg_fill_price>0.00000</avg_fill_price>
          <exec_quantity>0.00000</exec_quantity>
          <last_fill_price>0.00000</last_fill_price>
          <last_fill_quantity>0.00000</last_fill_quantity>
          <remaining_quantity>0.00000</remaining_quantity>
          <create_date>2014-05-28T12:05:51.673Z</create_date>
          <transaction_date>2014-05-28T12:05:51.673Z</transaction_date>
          <option_symbol>F140530C00016000</option_symbol>
        </leg>
      </order>
    </orders>
  </account>
  <account>
    <account_number>87654321</account_number>
    <orders>
      <order>
        <id>222</id>
        <type>limit</type>
        <symbol>GE</symbol>
        <side>sell_to_open</side>
        <quantity>5.00000</quantity>
        <status>filled</status>
        <duration>day</duration>
        <price>0.52000</price>
        <avg_fill_price>0.56000</avg_fill_price>
        <exec_quantity>5.00000</exec_quantity>
        <extended_hours>false</extended_hours>
        <last_fill_price>0.56000</last_fill_price>
        <last_fill_quantity>5.00000</last_fill_quantity>
        <remaining_quantity>0.00000</remaining_quantity>
        <stop_price>0.00000</stop_price>
        <request_date>2013-10-02T15:05:11.260Z</request_date>
        <response_date>2013-10-02T15:05:18Z</response_date>
        <strategy>unknown</strategy>
        <class>option</class>
        <num_legs>1</num_legs>
        <option_symbol>GE140118C00025000</option_symbol>
      </order>
      <order>
        <id>333</id>
        <type>market</type>
        <symbol>SPY</symbol>
        <side>sell_to_close</side>
        <quantity>25.00000</quantity>
        <status>filled</status>
        <duration>day</duration>
        <price>0.00000</price>
        <avg_fill_price>1.93000</avg_fill_price>
        <exec_quantity>25.00000</exec_quantity>
        <extended_hours>false</extended_hours>
        <last_fill_price>1.93000</last_fill_price>
        <last_fill_quantity>13.00000</last_fill_quantity>
        <remaining_quantity>0.00000</remaining_quantity>
        <stop_price>0.00000</stop_price>
        <request_date>2013-10-02T13:43:03.780Z</request_date>
        <response_date>2013-10-02T13:43:05Z</response_date>
        <strategy>unknown</strategy>
        <class>option</class>
        <num_legs>1</num_legs>
        <option_symbol>SPY131004P00170000</option_symbol>
      </order>
    </orders>
  </account>
</accounts>

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.