snaptrade is the quickest way to get started with the SnapTrade API. Link your own brokerage accounts, manage your portfolios, and execute live trades all from the command line!
Install the CLI globally using npm:
npm install -g @snaptrade/snaptrade-cliThen run the CLI:
snaptradeWhen you run snaptrade <command> for the first time, you need to provide your SnapTrade client ID and consumer key
Once the credentials are set, call snaptrade connect to connect a new account. This will register a new SnapTrade user and open the Connection Portal in your default browser. Pick a broker of your choice to finish the connection process. If you don't have/want to use a live account, you can register an Alpaca paper account with just an email and choose Alpaca Paper in the Connection Portal.
Note
A free key only has access to a limited set of brokers and cannot execute live trades at the moment.
To see which brokers are supported along with whether trading is enabled, you can run snaptrade brokers.
Note
To see the latest broker support and capabilities, please refer to this Notion page.
You can also specify the broker directly with snaptrade connect --broker <broker slug> to skip the broker selection step of the Connection Portal.
Once connected, call snaptrade connections to list all current connections.
and snaptrade accounts to list all connected accounts.
Use snaptrade positions to list all positions for an account. You'll be prompted to select an account first.
or snaptrade positions --all to list all positions across all accounts.
To submit an equity order, use snaptrade trade equity. It'll prompt you for confirmation before continuing.
You can pass --useLastAccount to skip the account selector and use the previously selected account instead.
Note
A free key does not have access to trading at the moment. Please reach out to sales@snaptrade.com to discuss your trading usecase.
To submit a multi-leg option order, use snaptrade trade option. It'll prompt you for confirmation before continuing.
Once the order is submitted successfully, you have the option to cancel it if it hasn't been filled by the broker. You can find the broker order ID in the response:
To submit a cancellation request, use snaptrade cancel-order. It'll prompt you for confirmation before continuing.
To see a list of all your recent orders, including the one you just placed, use snaptrade orders.
This concludes the quick start guide. Check out our documentation for more information.
Usage: snaptrade [options] [command]
CLI tool to interact with SnapTrade API
Options:
-V, --version output the version number
--useLastAccount Use the last selected account for account specific commands (default: false)
--verbose Enable verbose output (default: false)
-h, --help display help for command
Commands:
status Get current status of your SnapTrade API credentials
brokers List all brokers available to connect
connect [options] Establish a new broker connection
reconnect [connectionId] Re-establish an existing disabled connection
disconnect [connectionId] Remove an existing broker connection
connections List all broker connections
accounts List all connected accounts
positions [options] List all positions for a given account
recent-orders List the most recent orders (within last 24 hours) for a given account
orders List all orders for a given account
instruments Get a list of available instruments from a broker
quote [symbols] Get the latest market quote
trade [options] Execute different types of trades (equity, options, crypto)
cancel-order [options] Cancel an existing order
profiles Manage SnapTrade CLI profiles
help [command] display help for command
You need the following before getting started:
- mise - manages the project specific node version
To run the cli locally:
npm install
npm link
snaptrade
To release a new version, run npm run release
