Trade
An order and its fills. Get trades and the trade operations return trades, and TRADE_UPDATED webhook events send one as data.
Fields
Trade It trade ID. Pass it as trade_id to execute or cancel the trade.
When the record was created.
When the record last changed.
The Trade It user who owns the trade.
The traded asset, or the underlying for options.
The account the trade is sent to.
Where the trade came from: ios_app, chatgpt, mcp, api, or discord, or brokerage:<brokerage id> for trades synced from brokerage history.
Screenshot the trade was created from.
The brokerage's order ID. Not included in webhook events.
0 for a simple buy/sell, 1 for options/multi-leg.
01Whether the trade buys or sells.
buysellWhether a multi-leg trade pays (debit) or receives (credit) its net premium. Null for simple trades.
debitcreditevenShares or coins ordered. A multi-leg trade counts its whole package as 1.
Units filled so far.
Units canceled. A canceled order can still be partly filled.
Dollar amount, for orders placed by value instead of units.
Average fill price, always positive. For multi-leg trades, the net cash for the whole package. Null until something fills.
Order status. complete, canceled, failed, and disconnected are final.
draftpendingplacedpartially_filledcompletecanceledfaileddisconnectedHow the order is priced.
marketlimitstopstop_limitLimit price, for limit and stop-limit orders. For multi-leg trades, the net premium per spread unit.
Price that triggers a stop or stop-limit order.
Take-profit exit attached to a buy.
Exit trigger level
Absolute price ($) or percent from entry price (%).
$%Stop-loss exit attached to a buy.
Exit trigger level
Absolute price ($) or percent from entry price (%).
$%How long the order stays active.
daygtciocfokWhen the order was sent to the brokerage.
When the order finished filling.
Why the trade failed.
Fees the brokerage charged.
Legs of a multi-leg trade. Null for simple trades.
Each item has:
Whether the leg trades an option or the underlying stock.
optionequityWhether the leg buys or sells.
buysellWhether the leg opens or closes a position.
opencloseOCC option contract symbol, e.g. 260717C00435000. Null for stock legs.
Number of option contracts, or shares for a stock leg.
The leg's fill price per share. Null when the brokerage only reports a price for the whole package.
Set when the trade records an option assignment, exercise, or expiration instead of an order.
assignmentexerciseexpirationAnalysis of the screenshot the trade was created from.
The traded asset. Returned by get_trades; webhook events only include asset_id.
The database ID. Use for lookups.
When the record was created.
When the record last changed.
Company or coin name.
Ticker symbol.
Asset type: 2 for stocks, 4 for crypto, 8 for indexes.
0248Logo image URL.
Short description of the asset.
Exchange the asset trades on.
ISO 10383 market identifier code of the exchange.
Underlying ticker, for derivatives.
Country the asset is listed in.
When the asset was delisted.
Balance
Money fields are Balance objects.
Amount in currency.
ISO 4217 currency code, such as USD.