.NET SDK for Alpaca Markets API

Package	Stable	Pre-release
Alpaca.Markets
Alpaca.Markets.Extensions

.NET Core Usage Example

1. Create a new console application in a new, empty folder by running dotnet new console.
2. Add a reference for Alpaca .NET SDK with dotnet add package Alpaca.Markets.
3. Replace the content of the auto-generated Program.cs file with this code snippet:

using System;
using Alpaca.Markets;
using System.Threading.Tasks;

namespace AlpacaExample
{
    internal static class Program
    {
        private const String KEY_ID = "";

        private const String SECRET_KEY = "";

        public static async Task Main()
        {
            var client = Environments.Paper
                .GetAlpacaTradingClient(new SecretKey(KEY_ID, SECRET_KEY));

            var clock = await client.GetClockAsync();

            if (clock != null)
            {
                Console.WriteLine(
                    "Timestamp: {0}, NextOpen: {1}, NextClose: {2}",
                    clock.TimestampUtc, clock.NextOpenUtc, clock.NextCloseUtc);
            }
        }
    }
}

4. Replace the KEY_ID and SECRET_KEY values with your data from the Alpaca dashboard.
5. Run the sample application using the dotnet run command and check the output. You should see information about the current market timestamp and when the market will open and close next.

See the UsageExamples project for near-to-real-world strategy implementation using this SDK and the Alpaca.Markets.Tests repository for SDK usage examples. The Wiki pages contain a lot of additional information about different aspects of this SDK (environments handling, authentication types, different order placement approaches, streaming client subscriptions handling, etc.).

Alpaca Data API subscription plans

Alpaca provides three different subscription plans for the Data API v2 real-time streaming data: Free, Unlimited, and Business. The first one offers only IEX data and has some subscription limits. Other plans provide complete SIP data without data subscription limits. The IAlpacaDataStreamingClient interface and its implementation from SDK provide unified access for both streams.

Use the Environments.Paper.GetAlpacaDataStreamingClient(...) factory method to create a client connected to the Free IEX data stream. Use the Environments.Live.GetAlpacaDataStreamingClient(...) code for the Unlimited and Business SIP data stream. So Paper environment for free data tier and Live for paid subscriptions.

Build instructions

1. Install your OS's latest version of the .NET 9.0 SDK.
2. Clone the local version of this repository or your fork (if you want to make changes).
3. Build the packages using the dotnet build command running in the root directory of the cloned repo.

Contributors

Thanks a lot for all the contributors. See the complete list of project supporters in the CONTRIBUTORS file.