How to auto-sync trades from Alpaca to TradesViz trading journal?

Quick Start

To auto-sync your Alpaca account, visit https://tradesviz.com/import/.
Use the first dropdown to choose your trading account, the second dropdown to choose Alpaca,
then switch to the Auto-Sync tab and follow the steps below.

You can also open Import/Export from your profile menu in the top-right corner.

Auto-Sync Setup Instructions

Alpaca is one of the most developer-friendly trading platforms out there and it's high time they had an excellent trading journal integration!

We will now explore how to pair your TradesViz account with your Alpaca account.

This post assumes that you have read the basics about auto importing in TradesViz.

Once you select your trading account and broker as "Alpaca" or "Alpaca (Paper)" on the trade auto-import page, a popup box will appear when you click on the "Connect account" button.

Here are the steps you need to follow:

1. Click on the link in the instructions in the popup box shown in the picture above.
2. This will redirect you to a secure Alpaca webpage where you need to enter your credentials to authenticate that you are the user of the Alpaca account (if you are not already logged in). After that, you will be asked to authorize access to TradesViz - Note here that we will ONLY be fetching orders. We DO NOT use ANY of the trading or account-modifying API endpoints.
3. Once you complete the authentication flow, you will be redirected to a TradesViz.com page where you must copy a code and paste it into the popup box shown as the first image in this blog post.
4. Once you return to the tradesviz.com's import page, click on the "Auto-import trades" tab, follow the same instructions of selecting the trading account and brokerage platform (Alpaca or Alpaca Paper) and now paste the code in the text field.

That's it! You are now connected to Alpaca and your trades will be auto-synced every 24 hrs! You can change the advanced import settings and turn on or off the auto-sync by clicking the auto-import settings on the same import page.

If you have any questions regarding your connections, please contact us at support@tradesviz.com!

Important Notes About Auto-Sync

• Auto-sync only brings in recent / new trades going forward. For older history, first do a one-time

manual file import from the Upload File tab, then enable auto-sync.

• TradesViz uses read-only access wherever the broker supports it. We never request trading,

transfer, or withdrawal permissions.

• Some brokers (OAuth-based) expire connections periodically and require you to reconnect.

Troubleshooting

• If the connection fails, double-check API keys / OAuth login and that required permissions are granted.
• Make sure the trading account in TradesViz matches the asset class (stocks vs. futures vs. crypto).
• If sync stops bringing in new trades, reconnect the broker from the Auto-Sync connections page.

Need Help?

Email support@tradesviz.com with your broker, the trading account name in
TradesViz, and a screenshot of the error.

If your broker is not yet supported for auto-sync, see our
supported brokers list or contact support to request it.

FAQ

Why are old trades missing after I connected auto-sync?

Auto-sync only fetches recent history. Import a historical CSV/Excel file first from the Upload File
tab, then enable auto-sync for new trades going forward.

How often does auto-sync run?

Connections are synced automatically on a recurring schedule (typically daily). You can also trigger a
manual sync from the Auto-Sync connections page.

Is auto-sync safe? Can TradesViz trade on my account?

No. TradesViz requests read-only access whenever the broker supports it. We do not place trades or move
funds. For OAuth-based brokers, the consent screen will show exactly which scopes are granted.

Full blog post

You can also read the original walkthrough on our blog: Alpaca auto-sync guide.

Updated on: 29/05/2026