Client Messages - LaserSell Documentation

Message Types

Type	Description
`ping`	Latency probe; server responds with `pong`.
`configure`	Initial session setup with wallets and strategy.
`update_strategy`	Change strategy parameters mid session.
`close_position`	Remove a position from tracking.
`request_exit_signal`	Manually request an exit transaction.
`update_wallets`	Add or remove wallets mid session.
`update_position_strategy`	Override strategy for a single position.
`update_watch_wallets`	Add or update watch wallets for copy trading.
`mirror_buy_result`	Report outcome of a mirror buy transaction.

`ping`

{
  "type": "ping",
  "client_time_ms": 1706000000000
}

Field	Type	Required	Description
`client_time_ms`	`number`	Yes	Client timestamp in milliseconds. Compare with `pong.server_time_ms` to measure latency.

`configure`

Sent once after receiving hello_ok. Sets the wallets to watch and the strategy to evaluate.

{
  "type": "configure",
  "wallet_pubkeys": [
    "WalletPubkey1...",
    "WalletPubkey2..."
  ],
  "strategy": {
    "target_profit_pct": 5.0,
    "stop_loss_pct": 1.5,
    "trailing_stop_pct": 3.0,
    "sell_on_graduation": false
  },
  "deadline_timeout_sec": 45,
  "send_mode": "helius_sender",
  "tip_lamports": 1000,
  "watch_wallets": [
    { "pubkey": "WatchWalletPubkey1..." },
    { "pubkey": "WatchWalletPubkey2...", "auto_buy": { "wallet_pubkey": "YourBuyWallet...", "amount_quote_units": 100000000 } }
  ],
  "mirror_config": {
    "max_positions_per_wallet": 1,
    "cooldown_sec": 30,
    "skip_creator_tokens": false,
    "max_active_sol": 5.0,
    "buy_slippage_bps": 2500,
    "min_liquidity_sol": null,
    "max_entry_drift_pct": null,
    "max_consecutive_losses": null
  }
}

Field	Type	Required	Description
`wallet_pubkeys`	`string[]`	Yes	One or more wallet public keys to monitor.
`strategy`	`object`	Yes	Strategy configuration. See Strategy Configuration.
`deadline_timeout_sec`	`number`	No	Seconds of inactivity before the server auto-generates an exit signal. Omit or set to `0` to disable.
`send_mode`	`string`	No	Transaction submission mode: `"rpc"`, `"helius_sender"`, or `"astralane"`. Default: `"rpc"`.
`tip_lamports`	`number`	No	Priority fee tip in lamports. Default: `1000` (0.001 SOL).
`watch_wallets`	`WatchWalletEntryMsg[]`	No	Optional list of external wallets to mirror for copy trading. Each entry has `pubkey` (string) and optional `auto_buy` (AutoBuyConfigMsg).
`mirror_config`	`MirrorConfigMsg`	No	Optional hardening settings for mirror trading. See Mirror Config below.

Mirror Config

The mirror_config object controls safety limits and behavior for mirror (copy) trading. All fields are optional; the server uses sensible defaults when omitted.

Field	Type	Default	Description
`max_positions_per_wallet`	`number`	`1`	Maximum concurrent mirrored positions per watched wallet. Additional signals are ignored until an existing position closes.
`cooldown_sec`	`number`	`30`	Minimum seconds between mirror buys from the same watched wallet.
`skip_creator_tokens`	`boolean`	`false`	When `true`, ignore buy signals where the watched wallet is the token creator.
`max_active_sol`	`number`	`5.0`	Maximum total SOL exposure across all active mirrored positions. New signals are skipped when this cap would be exceeded.
`buy_slippage_bps`	`number`	`2500`	Slippage tolerance in basis points for mirror buy transactions (2500 = 25%).
`min_liquidity_sol`	`number`	`null`	Minimum pool liquidity in SOL required to execute a mirror buy. `null` to disable.
`max_entry_drift_pct`	`number`	`null`	Maximum allowed price drift (%) from the watched wallet’s entry price. `null` to disable.
`max_consecutive_losses`	`number`	`null`	After this many consecutive losing trades from a watched wallet, the wallet is auto-disabled and a `mirror_wallet_auto_disabled` event is sent. `null` to disable.

The SDKs send configure automatically when you call StreamClient.connect() or StreamSession.connect().

All wallets in wallet_pubkeys must be registered to your account before connecting. The stream will reject unregistered wallets with error code wallet_not_registered.

`update_strategy`

Update the strategy without reconnecting. Takes effect immediately for all tracked positions.

{
  "type": "update_strategy",
  "strategy": {
    "target_profit_pct": 15.0,
    "stop_loss_pct": 3.0,
    "trailing_stop_pct": 7.0,
    "sell_on_graduation": true
  }
}

Field	Type	Required	Description
`strategy`	`object`	Yes	New strategy to apply.

session.updateStrategy({
  target_profit_pct: 15,
  stop_loss_pct: 3,
  trailing_stop_pct: 7,
});

session.sender().update_strategy({
    "target_profit_pct": 15.0,
    "stop_loss_pct": 3.0,
    "trailing_stop_pct": 7.0,
})

session.update_strategy(StrategyConfigMsg {
    target_profit_pct: 15.0,
    stop_loss_pct: 3.0,
    trailing_stop_pct: Some(7.0),
    sell_on_graduation: None,
}, None);

session.Sender().UpdateStrategy(stream.StrategyConfigMsg{
    TargetProfitPct: 15.0,
    StopLossPct:     3.0,
    TrailingStopPct: 7.0,
})

`close_position`

Remove a position from tracking. The server will stop monitoring PnL and will not generate exit signals for it. Identify the position by either position_id or token_account.

{
  "type": "close_position",
  "position_id": 1
}

Or by token account:

{
  "type": "close_position",
  "token_account": "ATA..."
}

Field	Type	Required	Description
`position_id`	`number`	No*	Position ID to close. Mutually exclusive with `token_account`.
`token_account`	`string`	No*	Token account address. Mutually exclusive with `position_id`.

*One of position_id or token_account is required.

// By handle (from StreamSession)
session.close(handle);

// By position ID (via sender)
session.sender().closeById(1);

// By token account
session.sender().closePosition("ATA...");

# By position ID
session.sender().close_by_id(1)

# By token account
session.sender().close_position("ATA...")

// By position handle
session.close(handle);

// By position ID
session.sender().close_by_id(1);

// By token account
session.sender().close_position("ATA...");

// By position ID
sender.CloseByID(1)

// By token account
sender.ClosePosition("ATA...")

`request_exit_signal`

Manually request the server to generate an exit transaction for a position, regardless of whether the strategy thresholds have been met.

{
  "type": "request_exit_signal",
  "position_id": 1,
  "slippage_bps": 3000
}

Or by token account:

{
  "type": "request_exit_signal",
  "token_account": "ATA...",
  "slippage_bps": 3000
}

Field	Type	Required	Description
`position_id`	`number`	No*	Position ID. Mutually exclusive with `token_account`.
`token_account`	`string`	No*	Token account. Mutually exclusive with `position_id`.
`slippage_bps`	`number`	No	Override slippage for this exit transaction.

*One of position_id or token_account is required. The server responds with an exit_signal_with_tx containing the unsigned transaction.

// Using StreamSession
session.requestExitSignal(handle, 3000);

// Using sender directly
session.sender().requestExitSignal("ATA...", 3000);
session.sender().requestExitSignalById(1, 3000);

session.sender().request_exit_signal("ATA...", slippage_bps=3000)
session.sender().request_exit_signal_by_id(1, slippage_bps=3000)

session.request_exit_signal(handle, Some(3000));

// Using sender directly
session.sender().request_exit_signal("ATA...", Some(3000));
session.sender().request_exit_signal_by_id(1, Some(3000));

sender.RequestExitSignal("ATA...", intPtr(3000))
sender.RequestExitSignalByID(1, intPtr(3000))

`update_wallets`

Add or remove wallets from the session without reconnecting. The server will start monitoring the new set and stop tracking wallets that are no longer listed.

{
  "type": "update_wallets",
  "wallet_pubkeys": [
    "WalletPubkey1...",
    "WalletPubkey3..."
  ]
}

Field	Type	Required	Description
`wallet_pubkeys`	`string[]`	Yes	Updated list of wallets to monitor.

session.sender().updateWallets([
  "WalletPubkey1...",
  "WalletPubkey3...",
]);

session.sender().update_wallets([
    "WalletPubkey1...",
    "WalletPubkey3...",
])

session.sender().update_wallets(vec![
    "WalletPubkey1...".into(),
    "WalletPubkey3...".into(),
]);

sender.UpdateWallets([]string{
    "WalletPubkey1...",
    "WalletPubkey3...",
})

`update_position_strategy`

Override the strategy for a single position without affecting other tracked positions.

{
  "type": "update_position_strategy",
  "position_id": 1,
  "strategy": {
    "target_profit_pct": 200.0,
    "stop_loss_pct": 5.0,
    "trailing_stop_pct": 10.0
  }
}

Field	Type	Required	Description
`position_id`	`number`	Yes	Position to override.
`strategy`	`object`	Yes	Strategy override for this position only.

session.sender().updatePositionStrategy(positionId, {
  target_profit_pct: 200,
  stop_loss_pct: 5,
  trailing_stop_pct: 10,
});

session.sender().update_position_strategy(position_id, {
    "target_profit_pct": 200.0,
    "stop_loss_pct": 5.0,
    "trailing_stop_pct": 10.0,
})

session.sender().update_position_strategy(position_id, StrategyConfigMsg {
    target_profit_pct: 200.0,
    stop_loss_pct: 5.0,
    trailing_stop_pct: 10.0,
    ..Default::default()
})?;

sender.UpdatePositionStrategy(positionID, stream.StrategyConfigMsg{
    TargetProfitPct: 200.0,
    StopLossPct:     5.0,
    TrailingStopPct: 10.0,
})

`update_watch_wallets`

Add or update watch wallets mid-session for copy trading. Replaces the current watch wallet list.

{
  "type": "update_watch_wallets",
  "watch_wallets": [
    { "pubkey": "WatchWalletPubkey1..." },
    { "pubkey": "WatchWalletPubkey2...", "auto_buy": { "wallet_pubkey": "YourBuyWallet...", "amount_quote_units": 100000000 } }
  ]
}

Field	Type	Required	Description
`watch_wallets`	`WatchWalletEntryMsg[]`	Yes	Updated list of wallets to mirror.

Each WatchWalletEntryMsg has:

Field	Type	Required	Description
`pubkey`	`string`	Yes	Public key of the wallet to watch.
`auto_buy`	`AutoBuyConfigMsg`	No	If set, automatically mirror buys from this wallet.
`mirror_sell`	`boolean`	No	Reserved for future use. When `true`, mirror sells from this wallet in addition to buys. Default: `false`. Currently unused.

AutoBuyConfigMsg:

Field	Type	Required	Description
`wallet_pubkey`	`string`	Yes	Your wallet that will execute the buy.
`amount_quote_units`	`number`	Yes	Amount in quote asset atomic units per buy.
`amount_usd1_units`	`number`	No	Amount in USD1 atomic units (alternative).

session.sender().updateWatchWallets([
  { pubkey: "WatchWalletPubkey1..." },
  { pubkey: "WatchWalletPubkey2...", auto_buy: { wallet_pubkey: "YourBuyWallet...", amount_quote_units: 100000000 } },
]);

session.sender().update_watch_wallets([
    {"pubkey": "WatchWalletPubkey1..."},
    {"pubkey": "WatchWalletPubkey2...", "auto_buy": {"wallet_pubkey": "YourBuyWallet...", "amount_quote_units": 100000000}},
])

session.sender().update_watch_wallets(vec![
    WatchWalletEntryMsg { pubkey: "WatchWalletPubkey1...".into(), auto_buy: None },
    WatchWalletEntryMsg {
        pubkey: "WatchWalletPubkey2...".into(),
        auto_buy: Some(AutoBuyConfigMsg {
            wallet_pubkey: "YourBuyWallet...".into(),
            amount_quote_units: 100000000,
            amount_usd1_units: None,
        }),
    },
])?;

sender.UpdateWatchWallets([]stream.WatchWalletEntryMsg{
    {Pubkey: "WatchWalletPubkey1..."},
    {Pubkey: "WatchWalletPubkey2...", AutoBuy: &stream.AutoBuyConfigMsg{
        WalletPubkey: "YourBuyWallet...", AmountQuoteUnits: 100000000,
    }},
})

`mirror_buy_result`

Reports the outcome of a mirror buy transaction back to the stream. Send this after you sign and submit (or fail to submit) the transaction from a mirror_buy_signal event. The stream uses this feedback to update internal state, track consecutive losses, and manage cooldown timers.

{
  "type": "mirror_buy_result",
  "mint": "TokenMint...",
  "success": true
}

Field	Type	Required	Description
`mint`	`string`	Yes	Token mint address from the original `mirror_buy_signal`.
`success`	`boolean`	Yes	`true` if the transaction was signed and submitted successfully, `false` otherwise.

session.sender().mirrorBuyResult("TokenMint...", true);

session.sender().mirror_buy_result("TokenMint...", True)

session.sender().mirror_buy_result("TokenMint...", true);

sender.MirrorBuyResult("TokenMint...", true)

​Message Types

​ping

​configure

​Mirror Config

​update_strategy

​close_position

​request_exit_signal

​update_wallets

​update_position_strategy

​update_watch_wallets

​mirror_buy_result

Message Types

`ping`

`configure`

Mirror Config

`update_strategy`

`close_position`

`request_exit_signal`

`update_wallets`

`update_position_strategy`

`update_watch_wallets`

`mirror_buy_result`