AI agent for traders
Corporate Action Adjustment Agent
Position, cost basis and orders reflect each corporate action correctly and agree with the broker
What it does
A stock split changes share counts and prices, a spin-off creates new positions with a cost basis split and a special dividend lowers the price. If internal records are not updated the same day, the positions, open orders and profit figures are wrong. This agent watches corporate action announcements for every holding. It applies each action to positions, cost basis and open orders in a draft: ratios, fractional shares, ex-dates and pay dates. After the broker posts the action, it compares its result with the broker's statement, line by line. If they differ, it finds the cause, such as a rounding rule, a different ratio or a late ex-date, and redoes the calculation. It repeats until the two agree or a difference is explained. The trader approves the adjustments before they are booked. Edge case: a reverse split pays cash for fractional shares, and the agent books the cash.
How it works
Follow the arrows from top to bottom. The orange dashed arrow is the loop: when a check fails, the agent goes back and tries again.
Read the steps as a list
- A corporate action is announced for a holding
- Read the announcement terms and dates
- Pull positions, cost basis and open orders for the security
- Compute adjusted quantity, price, cost basis and cash in lieu
- Flag open orders that need price or size changes
- Trader approves the draft adjustmentsThe agent waits here for your OK.
- After the ex-date, read the broker's posted entry
- Do quantity and cost basis match the broker?If not: find the difference, such as rounding or ratio, and recompute. Back to step 4.
- Update the internal record and note the outcome
- Do open orders now carry correct prices and sizes?If not: correct the orders and recheck. Back to step 4.
- Adjustments booked and log updated
How it decides
It applies the announced terms to each position and accepts the result only when quantity and cost basis agree with the broker within a set tolerance.
- Match quantity exactly and cost basis within $1
- Use the announced ratio and round fractions per the broker rule
- Flag open orders on the ex-date
- Escalate when the broker's entry is missing 2 days after the pay date
Make it yours
Every agent is a starting point. You choose these settings for your own situation.
- Cost basis tolerance (default $1)
- Actions covered (split, spin-off, dividend, merger)
- Broker feeds used
- Order change policy
What keeps you in control
It always asks you first
- Booking the adjustments
- Changing open orders
Hard limits
- Never changes orders on its own
- Keeps the original records unchanged
- Records the announcement source
It stops when
- Done: records match the broker
- Stop: the announcement terms are unclear or the broker entry is missing
Set it up
We guide you through the set-up, step by step
Members get the full set-up guide for this agent. No technical skills needed: you copy, paste and upload.
- One set of instructions to paste into your AI, with the clicks for ChatGPT, Claude, Microsoft 365 Copilot, Gemini and Grok
- The agent then walks you through connecting your own data, one source at a time
- A downloadable copy with the flow chart, the rules and the full guide