Tradier API Documentation

For more detailed documentation, please visit https://developer.tradier.com.

If you are a business interested in using this API, please send an email to techsupport@tradier.com to discuss partnerships and integration services. Thanks!

Last 7 days, UTC

Average Latency
3ms

Average Uptime
100.0%

Current Status
Online

  • No information
  • Outage
  • Disruption
  • Normal
Average latency determined from Mashape to API Response time
OAuth 2.0 Authentication Show OAuth URLs - Show Curl Example
 

Authorization code OAuth 2.0 authentication


Authentication
Description
Parameter
String

The client identifier given to you by the API provider.

Client Id

Required

String

The consumer secret given to you by the API provider.

Client Secret

Required

String

A space-delimited string of access scopes.
Example: Read Write Stream Market Trade

Scope

Optional

Authenticate

Please set the callback URL to: http://guardian.mashape.com/callback

Balances

HTTP 200 : string GET/user/balances
Get a user's balances

HTTP 200 : string GET/accounts/{account}/balances
Get an account's balances

Test console
Description
Parameter
string

An account number
Example: 12345678

account

Required

Cost Basis

HTTP 200 : string GET/user/costbasis
Get a user's cost basis

HTTP 200 : string GET/accounts/{account}/costbasis
Get an account's cost basis

Test console
Description
Parameter
string

An account number
Example: 12345678

account

Required

History

HTTP 200 : string GET/user/history
Get a user's history

Market Data

HTTP 200 : string GET/markets/history
Get historical pricing

Test console
Description
Parameter
string

An equity symbol
Example: aapl

symbols

Required

string

The start date
Example: 2013-11-08

start

Optional

string

The end date
Example: 2013-11-24

end

Optional

string

One of daily, weekly or monthly
Example: daily

interval

Required

HTTP 200 : string GET/markets/options/chains
Get option chains

Test console
Description
Parameter
string

An equity symbol
Example: aapl

symbols

Required

string

An expiration date
Example: 2013-11-08

expiration

Required

HTTP 200 : string GET/markets/options/expirations
Get option expirations

Test console
Description
Parameter
string

An equity symbol
Example: aapl

symbols

Required

HTTP 200 : string GET/markets/options/strikes
Get option strikes

Test console
Description
Parameter
string

An equity symbol
Example: aapl

symbols

Required

string

An expiration date
Example: 2013-11-08

expiration

Required

HTTP 200 : string GET/markets/quote
Get quotes

Test console
Description
Parameter
string

A comma-delimited list of equity or option symbols
Example: aapl,goog,ibm

symbols

Required

HTTP 200 : string GET/markets/calendar
Get the market calendar

Test console
Description
Parameter
string

Month
Example: 11

month

Optional

string

Year
Example: 2013

year

Optional

HTTP 200 : string GET/markets/clock
Get the market status

Orders

HTTP 200 : string GET/accounts/{account}/order/{id}
Get a specific order

Test console
Description
Parameter
string

An account number
Example: 12345678

account

Required

string

An order ID
Example: 654

id

Required

HTTP 200 : string GET/user/orders
Get a user's orders

HTTP 200 : string GET/accounts/{account}/orders
Get an account's orders

Test console
Description
Parameter
string

An account number
Example: 12345678

account

Required

Positions

HTTP 200 : string GET/user/positions
Get a user's positions

HTTP 200 : string GET/accounts/{account}/positions
Get an account's positions

Test console
Description
Parameter
string

An account number
Example: 12345678

account

Required

Trade

HTTP 200 : string DELETE/accounts/{account}/orders/{id}
Cancel an order

Test console
Description
Parameter
boolean

An order ID

id

Required

string

An account number
Example: 12345678

account

Required

HTTP 200 : string PUT/accounts/{account}/orders/{id}
Change an order

Test console
Description
Parameter
boolean

An order ID

id

Required

string

An account number
Example: 12345678

account

Required

string

One of day, GTC
Example: day

duration

Required

string

One of market, limit, stop, stop_limit for equity and option orders. One of market, debit, credit, even for multileg and combo
Example: market

type

Required

number

The limit price of the order, required for limit, stop_limit, credit, and debit orders.
Example: 5.00

price

Optional

number

The stop price, required for stop and stop_limit orders.
Example: 5.00

stop

Optional

HTTP 200 : string POST/accounts/{account}/orders
Create an order

For more details around complex orders, please visit: https://developer.tradier.com/documentation/trading/getting-started


Test console
Description
Parameter
string

An account number
Example: 12345678

account

Required

string

One of equity, options, multileg, combo
Example: equity

class

Required

string

An equity symbol
Example: aapl

symbol

Required

string

One of day, GTC
Example: day

duration

Required

string

Equity order options: buy, buy_to_cover, sell, sell_short. Option order options: buy_to_open, buy_to_close, sell_to_open, sell_to_close
Example: buy_to_open

side

Required

number

Order quantity
Example: 14

quantity

Required

string

One of market, limit, stop, stop_limit for equity and option orders. One of market, debit, credit, even for multileg and combo
Example: market

type

Required

number

The limit price of the order, required for limit, stop_limit, credit, and debit orders.
Example: 5.00

price

Optional

number

The stop price, required for stop and stop_limit orders.
Example: 5.00

stop

Optional

string

The option symbol for the order
Example: AAPL140118C00195000

option_symbol

Optional

HTTP 200 : string POST/accounts/{account}/orders
Preview an order

For more details around complex orders, please visit: https://developer.tradier.com/documentation/trading/getting-started


Test console
Description
Parameter
string

An account number
Example: 12345678

account

Required

string

One of equity, options, multileg, combo
Example: equity

class

Required

string

An equity symbol
Example: aapl

symbol

Required

string

One of day, GTC
Example: day

duration

Required

string

Equity order options: buy, buy_to_cover, sell, sell_short. Option order options: buy_to_open, buy_to_close, sell_to_open, sell_to_close
Example: buy_to_open

side

Required

number

Order quantity
Example: 14

quantity

Required

string

One of market, limit, stop, stop_limit for equity and option orders. One of market, debit, credit, even for multileg and combo
Example: market

type

Required

number

The limit price of the order, required for limit, stop_limit, credit, and debit orders.
Example: 5.00

price

Optional

number

The stop price, required for stop and stop_limit orders.
Example: 5.00

stop

Optional

string

The option symbol for the order
Example: AAPL140118C00195000

option_symbol

Optional

string

Example: checked

preview

Required

User

HTTP 200 : string GET/user/profile
Get a user's profile

Watchlists

HTTP 200 : string POST/watchlists/{id}/symbols
Add watchlist symbols

Test console
Description
Parameter
string

A watchlist ID
Example: my-watchlist

id

Required

string

Comma-delimited list of symbols
Example: aapl,goog,ibm

symbols

Required

HTTP 200 : string POST/watchlists
Create a watchlist

Test console
Description
Parameter
string

A watchlist name
Example: My Watchlist

name

Required

string

A comma-delimited list of symbols
Example: aapl,goog,ibm

symbols

Required

HTTP 200 : string DELETE/watchlists/{id}
Delete a watchlist

Test console
Description
Parameter
string

A watchlist ID
Example: my-watchlist

id

Required

HTTP 200 : string DELETE/watchlists/{id}/symbols/{symbol}
Delete a watchlist symbol

Test console
Description
Parameter
string

A watchlist ID
Example: my-watchlist

id

Required

string

A symbol
Example: aapl

symbol

Required

HTTP 200 : string GET/watchlists/{id}
Get a watchlist

Test console
Description
Parameter
string

A watchlist ID
Example: my-watchlist

id

Required

HTTP 200 : string GET/watchlists/{id}/symbols/{symbol}
Get a watchlist symbol

Test console
Description
Parameter
string

A watchlist ID
Example: my-watchlist

id

Required

string

A symbol
Example: aapl

symbol

Required

HTTP 200 : string PUT/watchlists/{id}
Update a watchlist

Test console
Description
Parameter
string

A watchlist ID
Example: my-watchlist

id

Required

HTTP 200 : string PUT/watchlists/{id}/symbols/{symbol}
Update a watchlist symbol

Test console
Description
Parameter
string

A watchlist ID
Example: my-watchlist

id

Required

string

A symbol
Example: aapl

symbol

Required

Consume this API completely for free!


By joining the mashape API marketplace you can start using Tradier API today!

Login to your account or signup: Create Account

or
   Signup with GitHub

By signing up you agree to our terms of service.