Options Trading

The Options API lets you trade US single-leg options from your JP account through the same unified order endpoints. Options are differentiated by setting instrument_type: OPTION and providing option-specific parameters including the legs array with strike price, expiration, and option type.

For stock trading, see the dedicated Stock Trading page.

Supported Order Types

Order Type	Description
MARKET	Execute at the current market price
LIMIT	Execute at the specified price or better
STOP_LOSS	Trigger a market order when the stop price is reached
STOP_LOSS_LIMIT	Trigger a limit order when the stop price is reached

Time in Force

Value	Description
DAY	Valid for the current trading day only
GTC	Good till cancelled

Trading Session

Value	Description
CORE	Core trading session only

Supported Strategies

Strategy	Description
SINGLE	Single-leg option order

Key Parameters

Order-Level Parameters (new_orders[])

Parameter	Required	Description
client_order_id	Yes	Unique client-defined order ID (max 32 chars, must be unique per account)
combo_type	Yes	NORMAL for standard orders
option_strategy	Yes	SINGLE
instrument_type	Yes	OPTION
market	Yes	US
symbol	Yes	Underlying symbol (e.g., AAPL)
order_type	Yes	MARKET, LIMIT, STOP_LOSS, or STOP_LOSS_LIMIT
side	Yes	BUY or SELL
quantity	Yes	Number of contracts
entrust_type	Yes	QTY (only quantity-based orders are supported)
time_in_force	Yes	DAY or GTC
support_trading_session	No	CORE (default)
limit_price	Conditional	Required for LIMIT and STOP_LOSS_LIMIT
stop_price	Conditional	Required for STOP_LOSS and STOP_LOSS_LIMIT
account_tax_type	Yes	Tax account type: GENERAL
margin_type	No	Margin account only: ONE_DAY or INDEFINITE
position_intent	No	Margin account only: BUY_TO_OPEN, BUY_TO_CLOSE, SELL_TO_OPEN, or SELL_TO_CLOSE
close_contracts	No	Array of contract details for closing specific positions (max 10)

Leg Parameters (legs[])

Parameter	Required	Description
instrument_type	Yes	OPTION
market	Yes	US
symbol	Yes	Underlying symbol (e.g., AAPL)
side	Yes	BUY or SELL
strike_price	Yes	Strike price of the option
option_expire_date	Yes	Expiration date in YYYY-MM-DD format
option_type	Yes	CALL or PUT
quantity	Yes	Number of contracts for this leg

Request Examples — Single-Leg

Buy Call (Limit)

Buy 1 AAPL call option at a limit price of $11.00, strike price $220, expiring 2026-06-19. Using a general tax account.

{
  "account_id": "<your_account_id>",
  "new_orders": [
    {
      "client_order_id": "<unique_id>",
      "combo_type": "NORMAL",
      "option_strategy": "SINGLE",
      "instrument_type": "OPTION",
      "market": "US",
      "symbol": "AAPL",
      "order_type": "LIMIT",
      "limit_price": "11.0",
      "side": "BUY",
      "quantity": "1",
      "entrust_type": "QTY",
      "time_in_force": "DAY",
      "account_tax_type": "GENERAL",
      "legs": [
        {
          "instrument_type": "OPTION",
          "market": "US",
          "symbol": "AAPL",
          "side": "BUY",
          "strike_price": "220.0",
          "option_expire_date": "2026-06-19",
          "option_type": "CALL",
          "quantity": "1"
        }
      ]
    }
  ]
}

Buy Put (Limit)

Buy 2 TSLA put options at a limit price of $8.50, strike price $255, expiring 2026-07-17. Using a specific tax account.

{
  "account_id": "<your_account_id>",
  "new_orders": [
    {
      "client_order_id": "<unique_id>",
      "combo_type": "NORMAL",
      "option_strategy": "SINGLE",
      "instrument_type": "OPTION",
      "market": "US",
      "symbol": "TSLA",
      "order_type": "LIMIT",
      "limit_price": "8.5",
      "side": "BUY",
      "quantity": "2",
      "entrust_type": "QTY",
      "time_in_force": "DAY",
      "account_tax_type": "GENERAL",
      "legs": [
        {
          "instrument_type": "OPTION",
          "market": "US",
          "symbol": "TSLA",
          "side": "BUY",
          "strike_price": "255.0",
          "option_expire_date": "2026-07-17",
          "option_type": "PUT",
          "quantity": "2"
        }
      ]
    }
  ]
}

Sell Call (Limit)

Sell 1 AAPL call option at a limit price of $5.00, strike price $230, expiring 2026-06-19.

{
  "account_id": "<your_account_id>",
  "new_orders": [
    {
      "client_order_id": "<unique_id>",
      "combo_type": "NORMAL",
      "option_strategy": "SINGLE",
      "instrument_type": "OPTION",
      "market": "US",
      "symbol": "AAPL",
      "order_type": "LIMIT",
      "limit_price": "5.0",
      "side": "SELL",
      "quantity": "1",
      "entrust_type": "QTY",
      "time_in_force": "DAY",
      "account_tax_type": "GENERAL",
      "legs": [
        {
          "instrument_type": "OPTION",
          "market": "US",
          "symbol": "AAPL",
          "side": "SELL",
          "strike_price": "230.0",
          "option_expire_date": "2026-06-19",
          "option_type": "CALL",
          "quantity": "1"
        }
      ]
    }
  ]
}

Sell Put (Limit)

Sell 1 NVDA put option at a limit price of $6.00, strike price $100, expiring 2026-07-17.

{
  "account_id": "<your_account_id>",
  "new_orders": [
    {
      "client_order_id": "<unique_id>",
      "combo_type": "NORMAL",
      "option_strategy": "SINGLE",
      "instrument_type": "OPTION",
      "market": "US",
      "symbol": "NVDA",
      "order_type": "LIMIT",
      "limit_price": "6.0",
      "side": "SELL",
      "quantity": "1",
      "entrust_type": "QTY",
      "time_in_force": "DAY",
      "account_tax_type": "GENERAL",
      "legs": [
        {
          "instrument_type": "OPTION",
          "market": "US",
          "symbol": "NVDA",
          "side": "SELL",
          "strike_price": "100.0",
          "option_expire_date": "2026-07-17",
          "option_type": "PUT",
          "quantity": "1"
        }
      ]
    }
  ]
}

Market Order

Buy 1 AAPL call option at market price.

{
  "account_id": "<your_account_id>",
  "new_orders": [
    {
      "client_order_id": "<unique_id>",
      "combo_type": "NORMAL",
      "option_strategy": "SINGLE",
      "instrument_type": "OPTION",
      "market": "US",
      "symbol": "AAPL",
      "order_type": "MARKET",
      "side": "BUY",
      "quantity": "1",
      "entrust_type": "QTY",
      "time_in_force": "DAY",
      "account_tax_type": "GENERAL",
      "legs": [
        {
          "instrument_type": "OPTION",
          "market": "US",
          "symbol": "AAPL",
          "side": "BUY",
          "strike_price": "220.0",
          "option_expire_date": "2026-06-19",
          "option_type": "CALL",
          "quantity": "1"
        }
      ]
    }
  ]
}

Stop Loss

Sell 1 AAPL call option when the option price drops to $3.00 (triggers a market order).

{
  "account_id": "<your_account_id>",
  "new_orders": [
    {
      "client_order_id": "<unique_id>",
      "combo_type": "NORMAL",
      "option_strategy": "SINGLE",
      "instrument_type": "OPTION",
      "market": "US",
      "symbol": "AAPL",
      "order_type": "STOP_LOSS",
      "stop_price": "3.0",
      "side": "SELL",
      "quantity": "1",
      "entrust_type": "QTY",
      "time_in_force": "DAY",
      "account_tax_type": "GENERAL",
      "legs": [
        {
          "instrument_type": "OPTION",
          "market": "US",
          "symbol": "AAPL",
          "side": "SELL",
          "strike_price": "220.0",
          "option_expire_date": "2026-06-19",
          "option_type": "CALL",
          "quantity": "1"
        }
      ]
    }
  ]
}

Stop Loss Limit

Sell 1 TSLA put option when the price drops to $4.00 (stop), then place a limit order at $3.80.

{
  "account_id": "<your_account_id>",
  "new_orders": [
    {
      "client_order_id": "<unique_id>",
      "combo_type": "NORMAL",
      "option_strategy": "SINGLE",
      "instrument_type": "OPTION",
      "market": "US",
      "symbol": "TSLA",
      "order_type": "STOP_LOSS_LIMIT",
      "stop_price": "4.0",
      "limit_price": "3.8",
      "side": "SELL",
      "quantity": "1",
      "entrust_type": "QTY",
      "time_in_force": "DAY",
      "account_tax_type": "GENERAL",
      "legs": [
        {
          "instrument_type": "OPTION",
          "market": "US",
          "symbol": "TSLA",
          "side": "SELL",
          "strike_price": "255.0",
          "option_expire_date": "2026-07-17",
          "option_type": "PUT",
          "quantity": "1"
        }
      ]
    }
  ]
}

What's Next

• Stock Trading — Stock and ETF order management (JP supports US stock trading)
• Trading API FAQ — Common questions and troubleshooting