Skip to main content
POST
newOrderAllocations

Headers

Authorization
string<JWT>
required

User API token.

Body

application/json
strategy_id
string
required

AlphaInsider strategy identifier.

allocations
object[]
required

The allocations array represents the strategy's complete desired position set: any current position omitted from the array is closed, and an empty array closes every position.

slippage
number
default:0.002

Slippage fraction reserved when sizing allocation-generated market orders, from 0 to 0.05 (5%). The default 0.002 means 0.2%. This limit is separate from the allocation limit of 2 (200%). Slippage does not set a limit price.

AlphaInsider applies the following conservative sizing buffer internally. BuyingPower = strategy_value * 2; all value amounts use the same normalized portfolio units. fee and Slippage are fractions, not percentages from 0 to 100.

  • MaxOrderTotal = BuyingPower * 2 allows for a full position reversal.
  • ConservativeFeeTotal = MaxOrderTotal * (fee * 2) reserves the collateral cost of fees (stocks: 0%; crypto: 0.25%).
  • ConservativeSlippageTotal = MaxOrderTotal * Slippage reserves cash for price movement.
  • FinalBuyingPower = BuyingPower - ConservativeFeeTotal - ConservativeSlippageTotal is the buying power used to size the targets.

For example, on a display scale where the portfolio is worth $5,000, BuyingPower is $10,000 and MaxOrderTotal is $20,000. With a crypto fee of 0.0025 and slippage of 0.002, the fee reserve is $100 and the slippage reserve is $40, leaving FinalBuyingPower of $9,860. This buffer reduces the sized exposure below the requested target; it is not the final execution price or cash cost. Submit your intended allocation fractions and slippage setting; AlphaInsider applies the buffer automatically.

Required range: 0 <= x <= 0.05Must be a multiple of 0.001

Response

Request was successful.

success
boolean

True when the request succeeded.

response
object[]

Endpoint-specific response payload, or an error message when success is false.