---
# System prepended metadata

title: tdameritrade api

---

# tdameritrade api

![](https://i.giphy.com/media/4NrS22khGCNG5q76qQ/giphy.webp)


### Accounts and Trading

### Orders

#### Cancel Order
https://api.tdameritrade.com/v1/accounts/{accountId}/orders/{orderId}
Cancel a specific order for a specific account.  

#### Get Order
https://api.tdameritrade.com/v1/accounts/{accountId}/orders/{orderId}
Get a specific order for a specific account.

#### Orders By Path
https://api.tdameritrade.com/v1/accounts/{accountId}/orders
Orders for a specific account.

#### Get Orders By Query
https://api.tdameritrade.com/v1/orders
All orders for a specific account or, if account ID isn't specified, orders will be returned for all linked accounts.

#### Place Order
https://api.tdameritrade.com/v1/accounts/{accountId}/orders
Place an order for a specific account. 

#### Replace Order
https://api.tdameritrade.com/v1/accounts/{accountId}/orders/{orderId}
Replace an existing order for an account. The existing order will be replaced by the new order. Once replaced, the old order will be canceled and a new order will be created.

### Saved Orders

#### Create Saved Order
https://api.tdameritrade.com/v1/accounts/{accountId}/savedorders
Save an order for a specific account.

#### Delete Saved Order
https://api.tdameritrade.com/v1/accounts/{accountId}/savedorders/{savedOrderId}
Delete a specific saved order for a specific account.

#### Get Saved Order
https://api.tdameritrade.com/v1/accounts/{accountId}/savedorders/{savedOrderId}
Specific saved order by its ID, for a specific account.

#### Get Saved Orders by Path
https://api.tdameritrade.com/v1/accounts/{accountId}/savedorders
Saved orders for a specific account.

#### Replace Saved Order
https://api.tdameritrade.com/v1/accounts/{accountId}/savedorders/{savedOrderId}
Replace an existing saved order for an account. The existing saved order will be replaced by the new order.

### Market Hours

#### Get Hours for Multiple Markets
https://api.tdameritrade.com/v1/marketdata/hours
Retrieve market hours for specified markets

#### Get Hours for a Single Market
https://api.tdameritrade.com/v1/marketdata/{market}/hours
Retrieve market hours for specified single market

### Movers

#### Get Movers
https://api.tdameritrade.com/v1/marketdata/{index}/movers
Top 10 (up or down) movers by value or percent for a particular market


### Price History

#### Get Price History
https://api.tdameritrade.com/v1/marketdata/{symbol}/pricehistory
Get price history for a symbol


### Quotes

#### Get Quote
https://api.tdameritrade.com/v1/marketdata/{symbol}/quotes
Get quote for a symbol

#### Get Quotes
https://api.tdameritrade.com/v1/marketdata/quotes
Get quote for one or more symbols


### Transaction History

#### Get Transaction
https://api.tdameritrade.com/v1/accounts/{accountId}/transactions/{transactionId}
Transaction for a specific account.

#### Get Transactions
https://api.tdameritrade.com/v1/accounts/{accountId}/transactions
Transactions for a specific account.


### User Info & Preferences

#### Get Preferences
https://api.tdameritrade.com/v1/accounts/{accountId}/preferences
Preferences for a specific account.

#### Get Streamer Subscription Keys
https://api.tdameritrade.com/v1/userprincipals/streamersubscriptionkeys
SubscriptionKey for provided accounts or default accounts.

#### GETGet User Principals
https://api.tdameritrade.com/v1/userprincipals
User Principal details.

#### Update Preferences
https://api.tdameritrade.com/v1/accounts/{accountId}/preferences
Update preferences for a specific account.

### Watchlist

#### Create Watchlist
https://api.tdameritrade.com/v1/accounts/{accountId}/watchlists
Create watchlist for specific account.This method does not verify that the symbol or asset type are valid.

#### Delete Watchlist
https://api.tdameritrade.com/v1/accounts/{accountId}/watchlists/{watchlistId}
Delete watchlist for a specific account.

#### Get Watchlist
https://api.tdameritrade.com/v1/accounts/{accountId}/watchlists/{watchlistId}
Specific watchlist for a specific account.

#### Get Watchlists for Multiple Accounts
https://api.tdameritrade.com/v1/accounts/watchlists

All watchlists for all of the user's linked accounts.
#### Get Watchlists for Single Account
https://api.tdameritrade.com/v1/accounts/{accountId}/watchlists
All watchlists of an account.

#### Replace Watchlist
https://api.tdameritrade.com/v1/accounts/{accountId}/watchlists/{watchlistId}
Replace watchlist for a specific account. This method does not verify that the symbol or asset type are valid.

#### Update Watchlist
https://api.tdameritrade.com/v1/accounts/{accountId}/watchlists/{watchlistId}
Partially update watchlist for a specific account: change watchlist name, add to the beginning/end of a watchlist, update or delete items in a watchlist. This method does not verify that the symbol or asset type are valid.


