allocate

Move a subaccount’s available balance into its classic-pool allocated balance — the margin classic (non-instant) positions trade against. The call is routed through the AccountLayer _call proxy so the SYMMIO core attributes it to the subaccount; the connected wallet must be the subaccount’s on-chain owner. The subaccount must not be suspended or in liquidation as Party A.

Instant flow: skip this. Instant trading spends the available balance — allocating moves funds out of it and reduces what an instant open can use. See Balance Model.


import { allocate } from "@symmio/trading-core";
 
const hash = await allocate(config, {
  account: "0xsub...",
  amount: 1_000000000000000000n, // 18 decimals
});

Parameters

accountAddressrequired

The subaccount to allocate into. The signer must equal its on-chain owner.

amountbigintrequired

Amount moved into allocated balance, in 18 decimals (not collateral decimals).

chainIdnumberoptional

Optional chain override.

simulateBeforeWritebooleanoptional

Dry-run via simulateContract first (defaults to the config’s setting, itself true by default).

Returns

Hash

The broadcast tx hash. Dry-run without sending via simulateAllocate(config, params).