Trade It

How to Place a Multi-Leg Options Order with an API

Last updated November 2026

Can one API place spreads at every brokerage?

Yes. Every operation is a POST to https://api.tradeit.app/api/tool/execute with a tool_name and params, whichever brokerage the user connected.

What do I need first?

An API key from the API keys page, or OAuth for a multi-user app (authentication docs).

How do I find the user's account?

curl https://api.tradeit.app/api/tool/execute \
  --header "Authorization: Bearer $TRADE_IT_ACCESS_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{ "tool_name": "get_accounts", "params": {} }'

Each account includes its brokerage_metadata, so you can check options support before offering a spread.

How do I create the spread?

Legs use OCC symbols (YYMMDD[C|P]STRIKE, strike × 1,000, padded to eight digits). This is a $580/$570 put debit spread:

curl https://api.tradeit.app/api/tool/execute \
  --header "Authorization: Bearer $TRADE_IT_ACCESS_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "tool_name": "create_options_trade",
    "params": {
      "symbol": "SPY",
      "legs": [
        { "type": "option", "action": "buy",  "position_effect": "open", "occ": "260620P00580000", "quantity": 1 },
        { "type": "option", "action": "sell", "position_effect": "open", "occ": "260620P00570000", "quantity": 1 }
      ],
      "direction": "debit",
      "order_type": "limit",
      "limit_price": 2.35,
      "time_in_force": "day",
      "account_id": 304
    }
  }'

Reading the limit price

limit_price is per spread unit, so 2.35 is a $235 package. The response comes back with status: "draft".

What should my user see before it's placed?

Every leg, the net direction, and the limit price. Execution is a separate call, so the review step lives in your app and looks however you want.

Trade It review modal for a two-leg AAPL call credit spread before execution

How do I place it?

curl https://api.tradeit.app/api/tool/execute \
  --header "Authorization: Bearer $TRADE_IT_ACCESS_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{ "tool_name": "execute_trade", "params": { "trade_id": 843 } }'

Then poll get_trades or subscribe to webhooks for fills.

Which brokerages accept spreads?

  • Charles Schwab
  • ETrade
  • Moomoo
  • Public
  • Robinhood
  • Tastytrade
  • TradeStation
  • Webull

The full reference is in the options API docs.

More questions

Is there a platform fee or minimum?

No. Platforms pay $2.50 per active user per month with no platform fee or monthly minimum, so you can launch with your first user. See pricing.

Can I build my own review screen?

Yes. The API works without the embedded Trade It modal, so the whole review and approval experience can live in your app.

Trade from wherever you work.

Connect your brokerage once and use it in AI assistants, your own app, and Discord.

Get started