Options post-trade considerations
For developers who already support options trading and need to handle positions after an order fills: expiration, tax withholding, and corporate actions.
Once an options position exists, a few things need your attention. This page covers where options positions appear, what to do before expiration, how tax applies to non-U.S. residents, and how corporate actions change option instruments. Each section links to the full guide.
Getting balances and positions
Options positions appear in DriveWealth's position endpoints. See Getting balances and positions for examples of how to capture them.
Exercise and expiration
An in-the-money contract can be exercised automatically at expiration. That can leave an account with a large stock position, or a negative cash balance, if it cannot cover the exercise. Before the expiration cutoff, check that each account has the buying power or shares to support exercise. If it does not, close the position or submit a do-not-exercise request.
See Exercising contracts & managing expiration for the endpoints and the cutoff rules.
Tax handling: IRS Section 871(m)
The IRS taxes some options positions held by non-U.S. residents. The tax applies to what the IRS calls "dividend equivalents": payments on positions that closely mirror the payment of an underlying dividend. It applies only under certain conditions.
See IRS Section 871(m) for Options for the eligibility rules and an example DEEM transaction.
Corporate actions
A corporate action on the underlying security usually affects its options too. Splits, dividends, and mergers are examples.
In most cases:
- The original option instrument is marked
INACTIVE. - A new option instrument is created for existing positions.
When this happens, you need to:
- Listen for an
instruments.updatedevent (the old instrument moves fromACTIVEtoINACTIVE) and aninstruments.createdevent (the new instrument). Also listen forpositions.updatedevents withupdateReasonofOPTION_SYMBOL_CHANGE. - Move each position to the new symbol. The old symbol goes to an
openQtyof 0 and the new symbol takes the same quantity. Update any symbol or instrument ID you store. - Don't treat the removal as a sale or close. The transactions are
MERGER_ACQUISITIONwith a type ofOPTION_SYMBOL_CHANGE, and no cash moves. - Disable buy-to-open on the new instrument. It is closing only, so
BUY_OPENorders are rejected. The customer can still sell the contract. - Show the new contract as a non-standard contract. A number added to the symbol, such as
MSFT1, marks it.
Options corporate action events carry more data than other corporate action events, because both the instrument and the option positions need updates. See Options corporate actions for the full event sequence and samples.
Updated 3 days ago