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

An array of positions the strategy should be allocated to.

slippage
number
default:0.002

Slippage represents the percentage offset from the current bid/ask price when placing a limit order. This adjustment helps ensure that orders are more likely to fill by accounting for potential price movements.

Please note that the allocations may not sum precisely to 100%. The following calculation illustrates our approach to determining a conservative buffer for potential fees and slippage:

  • MaxOrderTotal = BuyingPower * 2
    This calculates the maximum possible order total, representing a full position reversal (e.g., from maximum long to maximum short, or vice versa).
  • ConservativeFeeTotal = MaxOrderTotal * (fee * 2)
    This accounts for the buying power reduction due to fees, as fees are deducted from collateral. (Stock Fees: 0%, Crypto Fees: 0.25%).
  • ConservativeSlippageTotal = MaxOrderTotal * Slippage
    This reserves funds for the worst-case scenario of order fills impacted by slippage.
  • FinalBuyingPower = BuyingPower - ConservativeFeeTotal - ConservativeSlippageTotal
    The adjusted buying power after these reductions.
Required range: 0 <= x <= 2Must 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.