alpacahq / Alpaca-API

The Alpaca API is a developer interface for trading operations and market data reception through the Alpaca platform.
https://alpaca.markets/
141 stars 13 forks source link

Backwards compatibility/API stability #180

Open d-e-s-o opened 3 years ago

d-e-s-o commented 3 years ago

I'd like some help understanding your API backwards compatibility guarantees. If memory serves, you actually made some effort to not break client code in the past. For instance, earlier /v1 endpoints were used and incompatible changes were exposed eventually through /v2 ones.

And now I am seeing a change like this one merged, which randomly renames variants in the account activity for no apparent reason (CSR -> CSW), which, as per my understanding, is backwards compatibility breaking.

Can you please help me understand 1) what API stability guarantees you provide 2) how that change is in line with them

?