Look up an order-backed import suggestion for a broker position
POST/api/v1/reconciliation/order-import-suggestion
Read-only. Walks the broker's own filled-order history for the symbol
(a targeted, watermark-unfenced fetch) and
returns a suggestion only when an uninterrupted, same-direction run of
filled orders sums exactly to the position quantity and its weighted
average fill price matches the position's avgCost within tolerance.
Returns a discriminated outcome (#1540): match when the exact-match
bar is met, rejected with the matcher's typed reason when it ran
and said no, or lookup_not_run with a typed cause when the lookup
never reached the matcher (the broker does not support this - Alpaca
only - or the candidate fetch was rate limited). On anything other
than match, the caller should fall back to the snapshot
import-position endpoint; on rate_limited it is worth retrying.
Never a fuzzy or partial match.
Request
Responses
- 200
- 400
- 401
- 404
- 500
The lookup outcome - exactly one of the three shapes below, by outcome.
Validation error
Authentication required
code: ORDER_BACKED_IMPORT_ACCOUNT_NOT_FOUND - the account does
not exist or is not owned by the caller.
Server error