> ## Documentation Index
> Fetch the complete documentation index at: https://scalarfield.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Trading with Robinhood

> Connect a Robinhood account to Scalar Field — OAuth connection, US equities and ETF order semantics, quotes, and the research data functions available for equity strategies.

<Info>**Execution:** `venue.trade()` in chat code, `strategy.execute()` in strategy agents.</Info>

# Overview

Robinhood connects to Scalar Field via OAuth. Once linked, the account is a tradable venue: Scalar Field reads positions, balances, and order history, and places equity and ETF orders in the account.

| Specification | Value                                              |
| ------------- | -------------------------------------------------- |
| Instruments   | US equities and ETFs (no options or crypto orders) |
| Connection    | OAuth                                              |
| Fractional    | Yes                                                |
| Hours         | US market hours                                    |
| Quotes        | Last, bid, ask, volume (no order-book depth)       |
| Currency      | USD                                                |

# Order Semantics

* **Symbols are plain tickers** (`AAPL`, `SPY`).
* **Options and crypto orders are not supported** — equities and ETFs only.
* **Fractional quantities are supported.** Size from a dollar budget with `round(budget / price, 2)`.
* The `slippage_bps` parameter does not apply to brokerage venues.

# Connecting

Click "Connect" on the portfolio page and authorize with your Robinhood account.

# Usage

```python theme={null}
from scalarlib import venue

# Account snapshot
data = venue.account(account="ROBINHOOD")
print(data["accounts"][0]["portfolio_value"])

# Buy 2 shares of AAPL
resp = venue.trade("buy", "AAPL", 2, account="ROBINHOOD")
print(resp["status"], resp["avg_price"])
```

In strategy agents, use `strategy.execute(symbol, target_qty)` instead — see [Strategies](/trading/strategies).

# Data Functions

Equity research uses the cross-asset market-data functions; each links to its full reference:

| Function / dataset                                                                   | Purpose                                                  |
| ------------------------------------------------------------------------------------ | -------------------------------------------------------- |
| [Equity & ETF OHLCV](/market-data/equity-ohlcv)                                      | Historical price bars for backtesting and signals        |
| [Latest Price Snapshot](/market-data/latest-price)                                   | Live last/bid/ask quotes for sizing and execution checks |
| [Earnings](/market-data/earnings)                                                    | Earnings calendar and results                            |
| [Insider Trades](/market-data/insider-trades)                                        | SEC Form 4 insider transactions                          |
| [Congressional Trades](/market-data/congress-trades)                                 | Congressional trading disclosures                        |
| [Institutional Holdings](/market-data/institutional-holdings)                        | 13F institutional positions                              |
| [Economic Releases](/market-data/economic-releases) / [FRED](/market-data/fred-data) | Macro event and series data                              |

# Notes

* Avoid trading directly in the Robinhood app while strategies are active on the account — see [Reconciliation](/trading/reconciliation) for how position mismatches are handled.
* Orders submitted outside market hours are queued for the next market open.

# Related

* [Strategies](/trading/strategies) — automated strategy execution
* [Reconciliation](/trading/reconciliation) — position sync and freeze/unfreeze behavior
* [Supported Venues](/trading/supported-brokerages) — venue registry and `venue.*` functions