NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #3940 most downloaded on PyPI
The Official Python SDK for Alpaca APIs
Latest stable
0.45.0
Last release 17 days ago
05 Nov 2026
Release timing varies
gaps range from 9 days to 6 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
97 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
…and enum values the APIs now return. It also deprecates fields, methods, and enum members that Alpaca no longer sends. Most of those deprecations will…
This release fixes bugs in the streaming clients, broker requests, and trading models, and it parses additional fields and enum values the APIs now return. It also deprecates fields, methods, and enum members that Alpaca no longer sends. Most of those deprecations will be removed in the next release, so check your logs for DeprecationWarning before upgrading past 0.45.
TransferTiming is removed (#858). Importing it now raises ImportError. Remove the import and any timing= argument; the Broker API has ignored this field since 2021.pytz is no longer installed with alpaca-py. If your code imports pytz and relied on alpaca-py to install it, add it to your own dependencies.stop() from another thread no longer hangs, and a stop never carries over into the next run (#781, #840).StockDataStream supports every documented feed, including delayed_sip, boats, and overnight (#830).Deprecated items still work but emit a DeprecationWarning. Most are scheduled for removal in the next release.
get_all_subscriptions and get_all_runs (use get_subscriptions and get_runs), get_corporate_announcements and get_corporate_announcement_by_id (use CorporateActionsClient.get_corporate_actions()), get_all_accounts_positions, and get_transfer_events (#823, #825).daytrading_buying_power, pattern_day_trader, daytrade_count, dtbp_check, and pdt_check on 2026-07-06. These fields now return None.equity instead of portfolio_value, borrow_status instead of Asset.easy_to_borrow, and margin_requirement_long / margin_requirement_short instead of Asset.maintenance_margin_requirement (#802, #825).ActivityType.CIL and ActivityType.MEM, OrderStatus.PENDING_REVIEW, BankAccountType.NONE, TransferStatus.SETTLED, and several AssetExchange and AccountStatus members. The short AgreementType names (MARGIN, ACCOUNT, and so on) still work as aliases of the new *_AGREEMENT members (#789, #790).since_id and until_id stop working on 2027-02-15. Switch to since_ulid and until_ulid (#863).TrustedContact.street_address as a string: still accepted, and sent as a one-item list (#791, #819).borrow_status, cusip, and margin requirements; account crypto_tier, effective_buying_power, position_market_value, intraday_adjustments, and pending_reg_taf_fees; position qty_available; and order group_id and group_role for bracket, OTO, and OCO orders (#802, #805, #815).show_deliverables=True (#803).qty_exercised and qty_remaining (#816).get_subscriptions and get_runs return next_page_token (#823).AssetExchange.TXSE and the activity types, asset classes, order sides, and account types the APIs now return (#789, #826).get_transfers_for_account honors offset and raw_data=True, and get_account_activities honors raw_data=True (#822, #844).APIError instead of saving the error response as your file (#862).CreateAccountRequest checks every required disclosure, not only the last one (#788).legs as dicts (#801, #839).TimeFrame values are rejected before any request is sent, and the error names the unit you passed (#843, #847, #848)."AAPL" in bars (#786).websockets.legacy API (#838).Thanks to everyone who contributed, including the 11 first-time contributors listed below.
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.44.0...v0.45.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
fix(trading): validate order price requirements client-side - Breaking Change by @carlostasada in https://github.com/alpacahq/alpaca-py/pull/691
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.43.5...v0.44.0
fix: Tolerate Alpaca's deprecated PDT/DTBP account fields by @yushdotkapoor in https://github.com/alpacahq/alpaca-py/pull/686
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.43.4...v0.43.5
fix: add missing "other" value to DocumentType enum by @AlexandrosKyriakakis in https://github.com/alpacahq/alpaca-py/pull/667
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.43.3...v0.43.4
chore: Add Alex into codeowner by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/639
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.43.2...v0.43.3
fix: Update TaxIdType in enums.py by @chrisjtraver in https://github.com/alpacahq/alpaca-py/pull/636
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.43.1...v0.43.2
doc: Add documentation for GetOptionContractsRequest by @tnixon in https://github.com/alpacahq/alpaca-py/pull/626
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.43.0...v0.43.1
feat: Add account_type/account_sub_type by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/632
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.42.2...v0.43.0
fix: Add missing trade events by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/630
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.42.1...v0.42.2
docs: Deprecate get_corporate_announcements by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/616
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.42.0...v0.42.1
The response of get_corporate_actions is changed to include ID/CUSIPs fields.
get_corporate_actions is changed to include ID/CUSIPs fields.
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.41.0...v0.42.0
Updated the path to notebook for in README.md by @idsts2670 in https://github.com/alpacahq/alpaca-py/pull/607
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.40.2...v0.41.0
Add build_trading_bot_with_ChatGPT Folder and Initial Documentation by @idsts2670 in https://github.com/alpacahq/alpaca-py/pull/599
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.40.1...v0.40.2
fix: Update docs typos by @toastdave in https://github.com/alpacahq/alpaca-py/pull/592
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.40.0...v0.40.1
feat examples crypto: Add and refine example notebooks by @idsts2670 in https://github.com/alpacahq/alpaca-py/pull/589
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.39.4...v0.40.0
Use the maximum allowed page size for market data requests by @gnvk in https://github.com/alpacahq/alpaca-py/pull/583
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.39.3...v0.39.4
Added .ipynb files for option strategies / Fixed broken links in READ… by @idsts2670 in https://github.com/alpacahq/alpaca-py/pull/579
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.39.2...v0.39.3
Use 10 000 as the default page limit for marketdata queries by @gnvk in https://github.com/alpacahq/alpaca-py/pull/578
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.39.1...v0.39.2
fix: Adjust docstring of TradingClient.cancel_order_by_id() by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/570
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.39.0...v0.39.1
chore: Add stale github actions by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/562
SETTLED to TransferStatus enum by @dtatarkin in https://github.com/alpacahq/alpaca-py/pull/567Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.38.0...v0.39.0
fix: Fix position_intent for mleg order by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/557
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.37.0...v0.38.0
feat: Add multi-leg options by @aarjaneiro in https://github.com/alpacahq/alpaca-py/pull/552
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.36.0...v0.37.0
fix: In-notebook install command no longer triggered if alpaca already importable by @aarjaneiro in https://github.com/alpacahq/alpaca-py/pull/550
alpaca already importable by @aarjaneiro in https://github.com/alpacahq/alpaca-py/pull/550Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.35.1...v0.36.0
chore(deps-dev): bump jinja2 from 3.1.4 to 3.1.5 by @dependabot in https://github.com/alpacahq/alpaca-py/pull/543
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.35.0...v0.35.1
feat: Add position_intent into order model by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/540
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.34.0...v0.35.0
Update quotes.py docstring by @kushalj1997 in https://github.com/alpacahq/alpaca-py/pull/532
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.33.1...v0.34.0
fix: Support websockets 14 by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/528
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.33.0...v0.33.1
The response of StockHistoricalDataClient is changed when no data with specifying only 1 symbol in the query
StockHistoricalDataClient is changed when no data with specifying only 1 symbol in the query
{} instead of {"AAPL": []}get_stock_bars()get_stock_quotes()get_stock_trades()get_stock_latest_bar()get_stock_latest_quote()get_stock_latest_trade()get_stock_snapshot()Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.32.0...v0.33.0
feat: Add options/custodial_customer agreements by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/513
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.31.0...v0.32.0
BrokerClient.cancel_orders_for_account() returns alpaca.trading.requests.CancelOrderResponse instead of alpaca.broker.requests.CancelOrderResponse
BrokerClient.cancel_orders_for_account() returns alpaca.trading.requests.CancelOrderResponse instead of alpaca.broker.requests.CancelOrderResponseFull Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.30.3...v0.31.0
doc: Remove beta for options by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/511
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.30.2...v0.30.3
doc: Add a comment to reset paper account when qty must be integer by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/500
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.30.1...v0.30.2
fix: Add activity types by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/501
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.30.0...v0.30.1
feat: Add updated_since to the option chain request by @gnvk in https://github.com/alpacahq/alpaca-py/pull/498
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.29.0...v0.30.0
feat: Crypto Historical Quotes by @IsaacTrevino in https://github.com/alpacahq/alpaca-py/pull/438
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.28.3...v0.29.0
fix: Fix historical news data by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/495
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.28.2...v0.28.3
fix: updated the notebooks to use explicit imports by @DavidMiklo in https://github.com/alpacahq/alpaca-py/pull/494
Transfer pydantic model by @dtatarkin in https://github.com/alpacahq/alpaca-py/pull/496Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.28.1...v0.28.2
chore(deps-dev): bump zipp from 3.18.1 to 3.19.1 by @dependabot in https://github.com/alpacahq/alpaca-py/pull/486
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.28.0...v0.28.1
chore(deps): bump idna from 3.6 to 3.7 by @dependabot in https://github.com/alpacahq/alpaca-py/pull/442
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.27.1...v0.28.0
fix: Fix get_corporate_announcements() by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/480
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.27.0...v0.27.1
We enhanced Market Data Streaming. However, there could be incompatibility changes (assuming most of users may not be impacted)
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.26.1...v0.27.0
fix: Change Visa_Type to match API expectations. by @RayOconnor in https://github.com/alpacahq/alpaca-py/pull/478
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.26.0...v0.26.1
feat: Add sandbox data support by @DeXtreme in https://github.com/alpacahq/alpaca-py/pull/464
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.25.0...v0.26.0
feat: Add asof parameter to historical stock data requests by @gnvk in https://github.com/alpacahq/alpaca-py/pull/477
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.24.0...v0.25.0
feat: Add kyc_results into broker account by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/467
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.23.0...v0.24.0
set BrokerClient.delete_account() deprecated. Please use BrokerClient.close_account() instead. BrokerClient.delete_account() will be removed in the fu…
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.22.0...v0.23.0
feat: Add transmitter info into BatchJournalRequestEntry by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/459
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.21.2...v0.22.0
Update Agreement model in accounts by @helhadry in https://github.com/alpacahq/alpaca-py/pull/461
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.21.1...v0.21.2
fix: Add correct JournalStatus by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/448
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.21.0...v0.21.1
get_option_snapshot returns OptionsSnapshot instead of Snapshot
get_option_snapshot returns OptionsSnapshot instead of Snapshotget_option_chain returns OptionsSnapshot instead of SnapshotFull Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.20.4...v0.21.0
Add new colab notebooks inside examples folder by @ggrace01 in https://github.com/alpacahq/alpaca-py/pull/440
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.20.3...v0.20.4
fix: Relax websockets version requirements by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/435
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.20.2...v0.20.3
fix: Change profit_loss_pct to List[Optional[float]] in PortfolioHistory model by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/430
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.20.1...v0.20.2
feat: Support position intent in order requests by @matebudai in https://github.com/alpacahq/alpaca-py/pull/428
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.20.0...v0.20.1
chore: Bump black to v24.3.0 by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/425
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.19.1...v0.20.0
fix: use int for max_options_trading_level of AccountConfiguration by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/423
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.19.0...v0.19.1
feat: Support options market data api (historical bars/trades and exchange codes) by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/420
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.18.1...v0.19.0
doc: Update link to jupyter notebook in README by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/419
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.18.0...v0.18.1
get_option_contracts has incompatible changes, please refer below PR for the detail
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.17.1...v0.18.0
fix: Handle limit parameter by @hiohiohio in https://github.com/alpacahq/alpaca-py/pull/416
Full Changelog: https://github.com/alpacahq/alpaca-py/compare/v0.17.0...v0.17.1
One column per quarter.