alpaca-http

HTTP REST API client for the Alpaca trading platform.

Overview

alpaca-http is a robust HTTP client for interacting with Alpaca's REST API. It handles authentication, request signing, and provides a clean interface for trading and market data endpoints.

Features

Trading Endpoints: Create, list, and cancel orders; manage positions and accounts.
Market Data: Access historical and real-time stocks and crypto data.
Advanced Order Support: Easily configure bracket, OCO, and OTO orders.
Broker API: Integrated support for Broker-specific endpoints and KYC.

Installation

Add to your Cargo.toml:

[dependencies]
alpaca-http = "0.21.1"

Usage

use alpaca_http::{AlpacaHttpClient, CreateOrderRequest};
use alpaca_base::{Credentials, Environment, OrderSide};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let credentials = Credentials::from_env()?;
    let client = AlpacaHttpClient::new(credentials, Environment::Paper)?;

    let account = client.get_account().await?;
    println!("Account status: {:?}", account.status);

    Ok(())
}

Examples

Run examples with cargo run -p alpaca-http --example <name>:

Trading Examples

Example	Description
`http_get_account`	Get account information
`http_create_market_order`	Create market orders
`http_create_limit_order`	Create limit orders
`http_list_orders`	List and filter orders
`http_cancel_order`	Cancel orders
`http_get_positions`	List positions
`http_close_position`	Close positions

Market Data Examples

Example	Description
`http_get_bars`	Fetch historical bars
`http_get_quotes`	Fetch quote data
`http_get_trades`	Fetch trade data
`http_list_assets`	List and filter assets
`http_get_clock`	Get market clock
`http_get_calendar`	Get market calendar

Broker API Examples

Example	Description
`http_create_broker_account`	Create broker accounts
`http_get_broker_account`	Get and list broker accounts
`http_ach_relationships`	Manage ACH funding
`http_transfers`	Create and manage transfers
`http_journals`	Create journal entries
`http_documents`	List and retrieve documents
`http_ira_contributions`	Manage IRA contributions

Specialty Examples

Example	Description
`http_news`	Fetch market news
`http_exchange_rates`	Get FX exchange rates
`http_market_clock`	Check market open/close status
`http_trading_calendar`	Get trading calendar
`http_corporate_actions`	List corporate actions

Contribution and Contact

We welcome contributions to this project! If you would like to contribute, please follow these steps:

Fork the repository.
Create a new branch for your feature or bug fix.
Make your changes and ensure that the project still builds and all tests pass.
Commit your changes and push your branch to your forked repository.
Submit a pull request to the main repository.

If you have any questions, issues, or would like to provide feedback, please feel free to contact the project maintainer:

Contact Information

Author: Joaquín Béjar García
Email: jb@taunais.com
Telegram: @joaquin_bejar
Repository: https://github.com/joaquinbejar/alpaca-rs
Documentation: https://docs.rs/alpaca-http

We appreciate your interest and look forward to your contributions!

License: MIT

Disclaimer

This software is not officially associated with Alpaca Markets. Trading financial instruments carries risk, and this library is provided as-is without any guarantees. Always test thoroughly with a paper trading account before using in a live trading environment.

alpaca-http 0.21.1