borsa-alphavantage

Alpha Vantage connector for the borsa financial data ecosystem.

Overview

borsa-alphavantage implements the BorsaConnector trait using the Alpha Vantage API to provide quotes, historical data, and fundamentals.

This connector is experimental and lightly tested due to API key requirements. Maintenance is best‑effort: I review PRs and may update when time allows, so it may lag behind breaking borsa releases. Treat it as a proof of concept and validate for your workloads before relying on it in production.

Installation

[dependencies]
borsa-alphavantage = "0.2.0"
borsa-core = "0.2.0"

Usage

Refer to the main borsa crate for how to register connectors. This crate implements BorsaConnector and can be added to a borsa client builder.

Feature flag: Closure-based adapter helpers (for dependency-free tests) live behind the optional test-adapters feature. Enable it in Cargo.toml or via cargo test --features borsa-alphavantage/test-adapters whenever you depend on the mocks.

Examples

Run a local example that loads your Alpha Vantage API key from a .env file.

1. Create a .env file at the repo root with:

   ALPHAVANTAGE_API_KEY=your_api_key_here
   

2. Run the showcase example:

   cargo run --example showcase
   

This will demonstrate quotes, history, search, earnings, and a simple forex request using AvConnector.

Contributing

See CONTRIBUTING.md. Please also read our Code of Conduct.

License

This project is licensed under the MIT License - see the LICENSE file for details.