Skip to main content
POST
Agent reports exit (Open → Closed)

Path Parameters

card_id
string
required

Body

application/json

Agent reports position exit (Open → Closed/Exited).

realized_pnl
required

Final realized P&L

fill
Fill · object | null

Exit fill details

costs
CardCosts · object | null
market_snapshot
MarketSnapshot · object | null

Frozen picture of the market state at the moment an agent made a decision. Required on audit entries where actor=agent and the action changes card state. See spec §4.5.

reason
string
default:""

Exit trigger (stop_hit, target_hit, time_stop, etc.)

Response

Successful Response

Response for all agent actions.

card_id
string<uuid>
required
action
string
required
column_state
string
default:""
substate
string | null
success
boolean
default:true
message
string
default:""