Placing Orders

After making a client object (e.g. client = schwabdev.Client(...)) you can place orders using methods outlined below.

Notes

client.place_order(account_hash, order)

Places an order for the account specified by account_hash. Returns Order ID in the headers (order_id = resp.headers.get('location', '/').split('/')[-1]), unless the order was instantly filled. Check response code for success.

client.order_details(account_hash, order_id)

Returns a requests.Response whose JSON body is a dict containing details for a specific order.

client.cancel_order(account_hash, order_id)

Cancels a specific order and returns a requests.Response. The response is typically empty if successful, check the code to know for sure.

client.replace_order(account_hash, orderID, order)

Replaces an existing order with a new order definition. Returns a requests.Response, check the code to know if successful.

client.preview_order(account_hash, order)

Returns a requests.Response representing a preview of the order (fees, validation, balances, etc) without actually placing it.

Order Examples

Please adjust for your usage.

Buy 10 shares of AMD at market price

order = {
    "orderType": "MARKET",
    "session": "NORMAL",
    "duration": "DAY",
    "orderStrategyType": "SINGLE",
    "orderLegCollection": [
        {
            "instruction": "BUY",
            "quantity": 10,
            "instrument": {
                "symbol": "AMD",
                "assetType": "EQUITY",
            },
        }
    ],
}

Buy 4 shares of INTC at limit price $10.00

order = {
    "orderType": "LIMIT",
    "session": "NORMAL",
    "duration": "DAY",
    "orderStrategyType": "SINGLE",
    "price": "10.00",
    "orderLegCollection": [
        {
            "instruction": "BUY",
            "quantity": 4,
            "instrument": {
                "symbol": "INTC",
                "assetType": "EQUITY",
            },
        }
    ],
}

Sell 3 options

Symbol format: Underlying Symbol (6 chars including spaces) + Expiration (YYMMDD, 6 chars) + Call/Put (1 char) + Strike Price (5+3 = 8 chars)

order = {
    "orderType": "LIMIT",
    "session": "NORMAL",
    "price": 1.0,
    "duration": "GOOD_TILL_CANCEL",
    "orderStrategyType": "SINGLE",
    "complexOrderStrategyType": "NONE",
    "orderLegCollection": [
        {
            "instruction": "SELL_TO_OPEN",
            "quantity": 3,
            "instrument": {
                "symbol": "AAPL  240517P00190000",
                "assetType": "OPTION",
            },
        }
    ],
}

Buy 3 options

Symbol format: Underlying Symbol (6 chars including spaces) + Expiration (YYMMDD, 6 chars) + Call/Put (1 char) + Strike Price (5+3 = 8 chars)

order = {
    "orderType": "LIMIT",
    "session": "NORMAL",
    "price": 0.1,
    "duration": "GOOD_TILL_CANCEL",
    "orderStrategyType": "SINGLE",
    "complexOrderStrategyType": "NONE",
    "orderLegCollection": [
        {
            "instruction": "BUY_TO_OPEN",
            "quantity": 3,
            "instrument": {
                "symbol": "AAPL  240517P00190000",
                "assetType": "OPTION",
            },
        }
    ],
}

Buy limited vertical put spread

order = {
    "orderType": "NET_DEBIT",
    "session": "NORMAL",
    "price": "0.10",
    "duration": "DAY",
    "orderStrategyType": "SINGLE",
    "orderLegCollection": [
        {
            "instruction": "BUY_TO_OPEN",
            "quantity": 2,
            "instrument": {
                "symbol": "XYZ   240315P00045000",
                "assetType": "OPTION",
            },
        },
        {
            "instruction": "SELL_TO_OPEN",
            "quantity": 2,
            "instrument": {
                "symbol": "XYZ   240315P00043000",
                "assetType": "OPTION",
            },
        },
    ],
}

Conditional Order: If 10 shares XYZ filled, then sell 10 shares ABC

order = {
    "orderType": "LIMIT",
    "session": "NORMAL",
    "price": "34.97",
    "duration": "DAY",
    "orderStrategyType": "TRIGGER",
    "orderLegCollection": [
        {
            "instruction": "BUY",
            "quantity": 10,
            "instrument": {
                "symbol": "XYZ",
                "assetType": "EQUITY",
            },
        }
    ],
    "childOrderStrategies": [
        {
            "orderType": "LIMIT",
            "session": "NORMAL",
            "price": "42.03",
            "duration": "DAY",
            "orderStrategyType": "SINGLE",
            "orderLegCollection": [
                {
                    "instruction": "SELL",
                    "quantity": 10,
                    "instrument": {
                        "symbol": "ABC",
                        "assetType": "EQUITY",
                    },
                }
            ],
        }
    ],
}

Conditional Order (OCO): If 2 shares XYZ filled, then cancel sell 2 shares ABC

order = {
    "orderStrategyType": "OCO",
    "childOrderStrategies": [
        {
            "orderType": "LIMIT",
            "session": "NORMAL",
            "price": "45.97",
            "duration": "DAY",
            "orderStrategyType": "SINGLE",
            "orderLegCollection": [
                {
                    "instruction": "SELL",
                    "quantity": 2,
                    "instrument": {
                        "symbol": "XYZ",
                        "assetType": "EQUITY",
                    },
                }
            ],
        },
        {
            "orderType": "STOP_LIMIT",
            "session": "NORMAL",
            "price": "37.00",
            "stopPrice": "37.03",
            "duration": "DAY",
            "orderStrategyType": "SINGLE",
            "orderLegCollection": [
                {
                    "instruction": "SELL",
                    "quantity": 2,
                    "instrument": {
                        "symbol": "ABC",
                        "assetType": "EQUITY",
                    },
                }
            ],
        },
    ],
}

Conditional Order: If 5 shares XYZ filled, then sell 5 shares ABC and 5 shares IJK

order = {
    "orderStrategyType": "TRIGGER",
    "session": "NORMAL",
    "duration": "DAY",
    "orderType": "LIMIT",
    "price": 14.97,
    "orderLegCollection": [
        {
            "instruction": "BUY",
            "quantity": 5,
            "instrument": {
                "assetType": "EQUITY",
                "symbol": "XYZ",
            },
        }
    ],
    "childOrderStrategies": [
        {
            "orderStrategyType": "OCO",
            "childOrderStrategies": [
                {
                    "orderStrategyType": "SINGLE",
                    "session": "NORMAL",
                    "duration": "GOOD_TILL_CANCEL",
                    "orderType": "LIMIT",
                    "price": 15.27,
                    "orderLegCollection": [
                        {
                            "instruction": "SELL",
                            "quantity": 5,
                            "instrument": {
                                "assetType": "EQUITY",
                                "symbol": "ABC",
                            },
                        }
                    ],
                },
                {
                    "orderStrategyType": "SINGLE",
                    "session": "NORMAL",
                    "duration": "GOOD_TILL_CANCEL",
                    "orderType": "STOP",
                    "stopPrice": 11.27,
                    "orderLegCollection": [
                        {
                            "instruction": "SELL",
                            "quantity": 5,
                            "instrument": {
                                "assetType": "EQUITY",
                                "symbol": "IJK",
                            },
                        }
                    ],
                },
            ],
        }
    ],
}

Sell Trailing Stop: 10 shares XYZ with a trailing stop offset of 10

order = {
    "complexOrderStrategyType": "NONE",
    "orderType": "TRAILING_STOP",
    "session": "NORMAL",
    "stopPriceLinkBasis": "BID",
    "stopPriceLinkType": "VALUE",
    "stopPriceOffset": 10,
    "duration": "DAY",
    "orderStrategyType": "SINGLE",
    "orderLegCollection": [
        {
            "instruction": "SELL",
            "quantity": 10,
            "instrument": {
                "symbol": "XYZ",
                "assetType": "EQUITY",
            },
        }
    ],
}

Iron Condor

order = {
    "orderStrategyType": "SINGLE",
    "orderType": "NET_CREDIT",
    "price": price,
    "orderLegCollection": [
        {
            "instruction": "SELL_TO_OPEN",
            "quantity": quantity,
            "instrument": {
                "assetType": "OPTION",
                "symbol": short_call_symbol,
            },
        },
        {
            "instruction": "BUY_TO_OPEN",
            "quantity": quantity,
            "instrument": {
                "assetType": "OPTION",
                "symbol": long_call_symbol,
            },
        },
        {
            "instruction": "SELL_TO_OPEN",
            "quantity": quantity,
            "instrument": {
                "assetType": "OPTION",
                "symbol": short_put_symbol,
            },
        },
        {
            "instruction": "BUY_TO_OPEN",
            "quantity": quantity,
            "instrument": {
                "assetType": "OPTION",
                "symbol": long_put_symbol,
            },
        },
    ],
    "complexOrderStrategyType": "CUSTOM",
    "duration": "DAY",
    "session": "NORMAL",
}