Skip to main content
POST
Portfolio-aware strategy signal

Body

application/json

Request body for portfolio-aware strategy signal.

market_query
string
required

Market question to analyze

portfolio
PortfolioPosition · object[]

Current portfolio positions

bankroll_usd
number
default:1000

Total bankroll in USD

Required range: x >= 0
max_position_pct
number
default:0.1

Max single position as fraction of bankroll

Required range: 0.01 <= x <= 0.5

Response

Successful Response

Strategy signal with portfolio context and adjusted sizing.

platform
string
required

kalshi, polymarket, robinhood, or coinbase

market_id
string
required

Market identifier

title
string
required

Market question

recommendation
string
required

BUY_YES, BUY_NO, NO_TRADE

target_price
number
required

Suggested entry price

Required range: 0 <= x <= 1
edge
number
required

estimated_prob - market_price

confidence
number
required

Confidence in the signal

Required range: 0 <= x <= 1
risk_rating
string
required

low, medium, high

base_size_pct
number
required

Kelly-derived size before portfolio adjustment

Required range: 0 <= x <= 1
adjusted_size_pct
number
required

Size after portfolio correlation adjustment

Required range: 0 <= x <= 1
adjusted_size_usd
number
required

Dollar amount based on adjusted_size_pct * bankroll

Required range: x >= 0
portfolio_impact
PortfolioImpact · object
required

How this trade affects portfolio risk

Example:
expires_at
string<date-time>
required

Signal staleness window

hedge_recommendations
HedgeRecommendation · object[]

Suggested hedges to reduce portfolio risk

generated_at
string<date-time>

When this signal was produced