Trading in your app.

Users connect their brokerage via OAuth; agents research and draft, the user approves every trade. Naïve is not a broker-dealer or investment adviser.

Get your API keyRead the docs
Tradingalpaca · connected
  • AAPL120+2.4%
  • NVDA40+1.1%
  • BTC0.5-0.6%
ordersmarket · limit
positionslive P&L
market dataquotes · bars
$ naive trading orders create --symbol AAPL --qty 10 --type market

Paste and ship

Drop this into Cursor, Claude Code, or any agent. It reads the skill manifest and wires up Trading for you.

Agent prompt

Read https://usenaive.ai/skill.md and set up Naïve for Trading in my project.

Trading primitives with a broker behind them.

OAuth-connected brokerage accounts, one order endpoint for every asset class, positions, and live quotes — governed by approvals, per user.

Connect once. Trade every asset class.

One OAuth handshake, then the same order endpoint trades stocks, options, and crypto — the symbol picks the market, and sensitive actions wait for a human.

POST /v1/trading/connect

Connect a brokerage account

Naive owns the platform OAuth app. connect returns an authorize_url; the user approves, the broker redirects to Naive's callback, and the token is exchanged and stored encrypted — per user, paper and/or live.

OAuth Connect
No token plumbing to build.
Paper & Live
Connect one or both envs.
Encrypted Tokens
Stored + isolated per user.
Disclosure
Consent copy returned to show.
# Connect a brokerage account (returns an authorize URL)
$ naive trading connect --env paper

# Once authorized, confirm the connection is active
$ naive trading connections
POST /v1/trading/orders

Place an Order

The same endpoint trades every asset class — the symbol selects the market (AAPL, BTC/USD, or an OCC option symbol). Provide qty or notional. Order placement is sensitive, so it's approval-gated by default.

Stocks · Options · Crypto
One symbol-driven endpoint.
qty or notional
Fractional dollar amounts.
Order Types
market, limit, stop, bracket.
Approval-Gated
Human signs off on spend.
# Buy $25 of BTC at market (crypto trades 24/7)
$ naive trading order --symbol BTC/USD --notional 25 --side buy --type market --tif gtc

# Buy 2 AAPL shares with a limit order, good-for-day
$ naive trading order --symbol AAPL --qty 2 --side buy --type limit --limit-price 150 --tif day
GET /v1/trading/positions

Positions

List open positions with live P/L, fetch one, or liquidate — fully or by percentage. Closing a position is sensitive, so it routes through the same approval gate as orders.

Open Positions
Qty, cost basis, live P/L.
Close / Liquidate
Sensitive — approval-gated.
Percentage Close
Trim with ?percentage=.
Paper or Live
?env= when both connected.
# List open positions
$ naive trading positions

# Close half of a position (SENSITIVE)
$ naive trading close AAPL --percentage 50
GET /v1/trading/market-data

Market Data

Pull the latest quote(s) for any symbol — crypto by default, equities with class=us_equity. Read-only, so no approval needed; pass comma-separated symbols for a batch.

Latest Quotes
Bid/ask for any symbol.
Crypto 24/7
BTC/USD, ETH/USD, …
Equities
class=us_equity.
Multi-Symbol
Comma-separated batch.
# Latest crypto quotes (default)
$ naive trading quote --symbols BTC/USD,ETH/USD

# Latest equity quote
$ naive trading quote --symbols AAPL --class us_equity

Add brokerage trading to your app.

OAuth-connected brokerage accounts, user-directed and approval-gated orders, and full position history — across paper and live.

Get your API keyRead the docs