Skip to main content
POST
Create action card

Body

application/json

Create a new action card.

Source-adaptive: manual cards need only core fields while debate/agent cards carry richer validation and market context.

source
enum<string>
required

How the action card was created.

Available options:
manual,
debate,
rules,
agent
underlying_symbol
string
required
instrument_type
enum<string>
required

Instrument type for the action card.

Available options:
equity,
option
instrument_symbol
string
required
direction
enum<string>
required
Available options:
LONG,
SHORT
timeframe
enum<string>
required
Available options:
intraday,
swing,
position
entry_price
required
stop_loss
required
targets
ActionCardTarget · object[]
required
source_id
string | null
group_id
string<uuid> | null
group_role
string | null
contract
ContractInfo · object | null

Options contract details.

premium_levels
PremiumLevels · object | null

Premium-based levels for options trades.

market_context
MarketContext · object | null

Combined market context for enrichment.

sizing
SizingInfo · object | null

Position sizing details.

entry_plan
EntryPlanInfo · object | null

Entry execution plan.

exit_plan
ExitPlanInfo · object | null

Exit execution plan.

risk_context
RiskContext · object | null

Risk guardian context at card creation.

validation
ValidationInfo · object | null

Validation context from debate or analysis.

backtest_edge
BacktestEdge · object | null

Historical backtest edge data.

time_validity
string | null
risk_reward

Response

Successful Response

Full action card response.

id
string<uuid>
required
user_id
string<uuid>
required
source
enum<string>
required

How the action card was created.

Available options:
manual,
debate,
rules,
agent
underlying_symbol
string
required
instrument_type
enum<string>
required

Instrument type for the action card.

Available options:
equity,
option
instrument_symbol
string
required
direction
enum<string>
required
Available options:
LONG,
SHORT
timeframe
enum<string>
required
Available options:
intraday,
swing,
position
entry_price
string
required
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
stop_loss
string
required
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
targets
ActionCardTarget · object[]
required
status
enum<string>
required

Action card lifecycle status.

Available options:
draft,
active,
monitoring,
closed,
expired,
dismissed
completeness
enum<string>
required

Completeness tier based on enrichment sections present.

Available options:
skeleton,
enriched,
actionable,
validated
created_at
string<date-time>
required
updated_at
string<date-time>
required
risk_reward
string | null
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
source_id
string | null
group_id
string<uuid> | null
group_role
string | null
contract
ContractInfo · object | null

Options contract details.

premium_levels
PremiumLevels · object | null

Premium-based levels for options trades.

market_context
MarketContext · object | null

Combined market context for enrichment.

sizing
SizingInfo · object | null

Position sizing details.

entry_plan
EntryPlanInfo · object | null

Entry execution plan.

exit_plan
ExitPlanInfo · object | null

Exit execution plan.

risk_context
RiskContext · object | null

Risk guardian context at card creation.

validation
ValidationInfo · object | null

Validation context from debate or analysis.

backtest_edge
BacktestEdge · object | null

Historical backtest edge data.

execution_id
string<uuid> | null
outcome
OutcomeInfo · object | null

Post-trade outcome tracking.

time_validity
string | null
change_log
Change Log · object[]
expires_at
string<date-time> | null