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.

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.