Place trades through the TD Ameritrade API using a range of parameters
td_placeOrder(
accountNumber,
ticker,
quantity,
instruction,
orderType = "MARKET",
limitPrice = NULL,
stopPrice = NULL,
assetType = c("EQUITY", "OPTION"),
session = "NORMAL",
duration = "DAY",
stopPriceBasis = NULL,
stopPriceType = NULL,
stopPriceOffset = NULL,
accessToken = NULL
)The TD brokerage account number associated with the Access Token
a valid Equity/ETF or option. If needed, use td_symbolDetail to confirm. This should be a ticker/symbol, not a CUSIP
the number of shares to be bought or sold. Must be an integer.
Equity instructions include 'BUY', 'SELL', 'BUY_TO_COVER', or 'SELL_SHORT'. Options instructions include 'BUY_TO_OPEN', 'BUY_TO_CLOSE', 'SELL_TO_OPEN', or 'SELL_TO_CLOSE'
MARKET, LIMIT (requiring limitPrice), STOP (requiring stopPrice), STOP_LIMIT, TRAILING_STOP (requiring stopPriceBasis, stopPriceType, stopPriceOffset)
the limit price for a LIMIT or STOP_LIMIT order
the stop price for a STOP or STOP_LIMIT order
EQUITY or OPTION. No other asset types are available at this time. EQUITY is the default.
NORMAL for normal market hours, AM or PM for extended market hours
how long will the trade stay open without a fill: DAY, GOOD_UNTIL_CANCEL, FILL_OR_KILL
LAST, BID, or ASK which is the basis for a STOP, STOP_LIMIT, or TRAILING_STOP
the link to the stopPriceBasis. VALUE for dollar difference or PERCENT for a percentage offset from the price basis
an integer that indicates the offset used for the stopPriceType, 10 and PERCENT is a 10 percent offset from the current price basis. 5 and VALUE is a 5 dollar offset from the current price basis
A valid Access Token must be set using
td_auth_accessToken. The most recent Access Token will be
used by default unless one is manually passed into the function.
the trade id, account id, and other order details
A valid account and access token must be passed. An access token will be
passed by default when td_auth_accessToken is executed
successfully and the token has not expired, which occurs after 30 minutes.
Only equities and options can be traded at this time. This function is built
to allow a single trade submission. More complex trades can be executed
through the API, but a custom function or submission will need to be
constructed. To build more custom trading strategies, reference the
TD Ameritrade
API Instructions or the
order
sample guide. A full list of the input parameters and details can be found
at the links above. Please note that in rare cases, the documentation may not
be accurate in the API section, so the Order Sample guide is a better
reference. TEST ALL ORDERS FIRST WITH SMALL DOLLAR AMOUNTS!!!
Four parameters are required for submission: ticker, instruction, quantity, and account number associated with the Access Token. The following parameters default: session - NORMAL, duration - DAY, asset type - EQUITY, and order type - MARKET
TRADES THAT ARE SUCCESSFULLY ENTERED WILL BE SUBMITTED IMMEDIATELY THERE IS NO REVIEW PROCESS. THIS FUNCTION HAS HUNDREDS OF POTENTIAL COMBINATIONS AND ONLY A HANDFUL HAVE BEEN TESTED. IT IS STRONGLY RECOMMENDED TO TEST THE DESIRED ORDER ON A VERY SMALL QUANTITY WITH LITTLE MONEY AT STAKE. ANOTHER OPTION IS TO USE LIMIT ORDERS FAR FROM THE CURRENT PRICE. TD AMERITRADE HAS THEIR OWN ERROR HANDLING BUT IF A SUCCESSFUL COMBINATION IS ENTERED IT COULD BE EXECUTED IMMEDIATELY. DOUBLE CHECK ALL ENTRIES BEFORE SUBMITTING.
if (FALSE) {
# Get stored refresh token
refreshToken = readRDS('/secure/location/')
# generate a new access token
accessToken = td_auth_accessToken(refreshToken, 'consumerKey')
# Set Account Number
accountNumber = 1234567890
# Standard market buy order
# Every order must have at least these 4 paramters
td_placeOrder(accountNumber = accountNumber,
ticker = 'AAPL',
quantity = 1,
instruction = 'buy')
# Stop limit order - good until canceled
td_placeOrder(accountNumber = accountNumber,
ticker = 'AAPL',
quantity = 1,
instruction = 'sell',
duration = 'good_till_cancel',
orderType = 'stop_limit',
limitPrice = 98,
stopPrice = 100)
# Trailing Stop Order
td_placeOrder(accountNumber = accountNumber,
ticker='AAPL',
quantity = 1,
instruction='sell',
orderType = 'trailing_stop',
stopPriceBasis = 'BID',
stopPriceType = 'percent',
stopPriceOffset = 10)
# Option Order with a limit price
td_placeOrder(accountNumber = accountNumber,
ticker = 'SLV_091820P24.5',
quantity = 1,
instruction = 'BUY_TO_OPEN',
duration = 'Day',
orderType = 'LIMIT',
limitPrice = .02,
assetType = 'OPTION')
}