API Breaking Change Notification for Unpriceable Assets

Current Issue and Customer Impact

There are cases when an account may have a position in an asset that does not have a current price. This can occur when certain corporate actions are processed or when a stock gets delisted.

In this scenario, API endpoints that call functions that use asset prices are returning an error response.

In order to avoid the error response and keep the API available even in the event that one of your positions’ underlying asset is missing a price, we will introduce a minor breaking change to the API.

Solution and API Breaking Change

Starting on September 9, 2021, the following API response fields will change from non-nullable to nullable. They will appear null in the response in the case that the underlying asset is missing the price for some reason.

Additionally, the following API response fields’ values will exclude the account’s position in the unpriceable asset.

Release Timeline

We plan for this change to take effect in the Trading API and Broker API live environments starting on September 9, 2021. For Paper Trading and the Broker API sandbox environment, we plan to enable this change on September 2, 2021. We’ll ensure that our SDKs are updated as well.

We understand the change may impact your client code but hope it will provide a better experience. Thank you for your understanding and please feel free to send any questions to [email protected].

Interested in learning more about Broker API?

Don't miss out on any updates about our Broker API suite of solutions! Share your details with us and be the first to know about our latest content.

You've successfully subscribed to Alpaca Blog | Developer-First API for Stocks and Crypto
Great! Next, complete checkout for full access to Alpaca Blog | Developer-First API for Stocks and Crypto
Welcome back! You've successfully signed in.
Success! Your account is fully activated, you now have access to all content.