RobinStocks 1.0.1

RobinStocks

A C# client library for the Robinhood brokerage API. Provides strongly-typed services for stocks, options, futures, crypto, orders, accounts, and market data.

Disclaimer: Robinhood does not publish an official public API. This library is based on reverse-engineered endpoints and may break without notice if Robinhood changes their API.

Install

dotnet add package RobinStocks

Quick Start

using RobinStocks;

// Create a client
var client = RobinStocksBuilder.CreateRobinhoodClient();

// Login (stored tokens are reused automatically on subsequent runs)
var success = await client.LoginAsync("your@email.com", "yourpassword");
if (!success)
{
    Console.WriteLine("Login failed — check credentials or approve in the Robinhood app.");
    return;
}

// Get a stock quote
var quote = await client.Stocks.GetQuoteAsync("AAPL");
Console.WriteLine($"AAPL: ${quote?.LastTradePrice}");

// Get options chain
var chain = await client.Options.GetOptionChainAsync("AAPL");

// Get account positions
var positions = await client.Account.GetPositionsAsync();

await client.LogoutAsync();

Authentication

Robinhood requires device approval for new logins. The first time you authenticate on a new machine, you will be prompted to approve the login in the Robinhood mobile app.

After the first successful login, the access token is stored at ~/.tokens/robinhood.json and reused automatically on subsequent runs — no re-approval needed unless the token expires.

TOTP / Authenticator App

If you have two-factor authentication enabled via an authenticator app, pass your TOTP secret:

await client.LoginAsync("your@email.com", "yourpassword", totpSecret: "YOUR_TOTP_SECRET");

MFA Code (SMS)

If you receive an SMS code, pass it directly:

await client.LoginAsync("your@email.com", "yourpassword", mfaCode: "123456");

Token Refresh

Tokens are valid for 24 hours. To refresh programmatically:

if (client.TokenExpiryTime < DateTime.UtcNow.AddMinutes(10))
    await client.RefreshTokenAsync();

Token Change Hook

Subscribe to token changes to persist tokens externally (e.g. to a Kubernetes secret):

var authService = /* resolve RobinhoodAuthenticationService from DI */;
authService.OnTokenRefreshed += async tokenData =>
{
    // persist tokenData.AccessToken, tokenData.RefreshToken, etc.
};

Dependency Injection (ASP.NET)

// Program.cs
builder.Services.AddRobinStocks();

// Inject RobinhoodClient wherever needed
public class MyService(RobinhoodClient client) { ... }

Services

Architecture

RobinhoodClient
├── StocksService       → api.robinhood.com
├── OptionsService      → api.robinhood.com
├── OrdersService       → api.robinhood.com
├── AccountService      → api.robinhood.com
├── MarketsService      → api.robinhood.com
├── ProfilesService     → api.robinhood.com
├── TradingTrendsService→ api.robinhood.com
├── CryptoService       → nummus.robinhood.com
└── FuturesService      → api.robinhood.com (arsenal/ceres)

All services share a single HttpClientService that manages the Bearer token and handles auth-stripping for OAuth endpoints.

License

MIT