Go library for accessing the IEX Cloud Legacy API.
As of August, 31, 2024, all IEX Cloud products will be retired. Therefore, the iexcloud Go library is archived and all development has ceased.
iexcloud provides a Go interface to the IEX Cloud Legacy API. To access the IEX Cloud Legacy API an account and token are required. The goal is for iexcloud to be compatible with the v1 version of the IEX Cloud Legacy API. There were some changes from the beta version to v1 of the API, so things may still be in flux for this library.
- IEX Cloud Legacy API uses https://cloud.iexapis.com/ for its base URL.
- IEX Cloud API uses https://api.iex.cloud/v1/ for its base URL.
$ go get github.com/goinvest/iexcloud/v2Examples are available at https://github.com/goinvest/iexcloud-examples/.
Please see implementation.md for the current implementation status of the IEX Cloud Legacy API.
Contributions are welcome! To contribute please:
- Fork the repository
- Create a feature branch
- Code
- Submit a pull request
Prior to submitting a pull request, please run:
$ make check # formats, vets, and unit tests the code
$ make lint # lints code using staticcheckTo update and view the test coverage report:
$ make coverTo perform the integration tests run:
$ make intPrior to doing so, you'll need to create a config_test.toml file with your IEX
Cloud API Token and the base URL. It is recommended to use your sandbox token
and the sandbox URL, so as to not be charged credits when running the
integration tests. Sandbox tokens start with Tpk_ instead of pk_ for
non-sandbox tokens. Using the sandbox does make integration a little more
difficult, since results are scrambled in sandbox mode.
Example config_test.toml file:
Token = "Tpk_your_iexcloud_test_token"
BaseURL = "https://sandbox.iexapis.com/v1"iexcloud is released under the MIT license. Please see the LICENSE file for more information.