beam

name	beam
version	0.0.31
description	Operate Beam, an autonomous Solana DLMM liquidity agent for Meteora pools. Use when the user asks about "beam", "DLMM", "liquidity agent", "Meteora pools", "rebalance positions", "paper trade Solana", or "start the trading agent".
license	MIT
author	irfndi
homepage	https://github.com/irfndi/beam-clmm
tags	["evm","defi","liquidity","uniswap-v3","uniswap-v4","trading-agent"]
compatibility	Requires Bun 1.4+, the `beam` CLI, and a Helius RPC key.
metadata	{"chain":"robinhood-chain (evm)","protocol":"uniswap-v3, uniswap-v4","openclaw":{"requires":{"bins":"[Truncated]"},"os":["darwin","linux"],"capabilities":["mcp","http"]},"hermes":{"tags":["evm","defi","liquidity","trading"],"category":"defi","requires_toolsets":["terminal"],"blueprint":{"schedule":"0 * * * *","deliver":"origin","prompt":"Check Beam status and alert the user to any important positions, decisions, or risks. Use `beam status --message` and summarize in 3-5 bullets.","no_agent":false}}}

Beam Liquidity Agent

Beam is an autonomous liquidity agent for Solana Meteora DLMM pools. It runs locally, makes deterministic rebalancing decisions, and can optionally ask a local agent runtime (Hermes via ACP or OpenClaw via Gateway) for a second opinion when running as an agent skill.

When to use

• User asks about liquidity pool management on Solana.
• User wants to check pool health or position performance.
• User needs to rebalance concentrated liquidity positions.
• User mentions Meteora DLMM, fee-IL ratio, volume authenticity, or bin arrays.
• User wants to start, stop, configure, or monitor the Beam trading agent.

Quick start

# Install dependencies
bun install

# Configure (non-interactive)
beam setup --non-interactive --rpc-url=$ROBINHOOD_RPC_URL

# Start paper trading (default)
beam dev

# Live trading (requires wallet)
export WALLET_PRIVATE_KEY=...
beam dev

Common commands

Command	Purpose
beam status --json	JSON snapshot for agents/skills
beam status --message	Markdown summary for messaging apps
beam dev	Start the trading agent
beam backtest --days 7	Run historical simulation
beam backtest --source replay --days 7 --pools <addr>	Replay on-chain snapshots
beam wallet show	Show wallet balance
beam whoami	Show account info

Decision flow

For each pool on each scan cycle:

1. Fetch pool state and bin array from Meteora via Helius RPC.
2. Compute metrics: fee/IL ratio, volume authenticity, bin utilization, TVL velocity.
3. Apply decision rules in order:
   • EXIT — TVL drop, stop-loss, trailing-stop, high volatility, low volume auth.
   • REBALANCE — drift > 60%, OOR grace expired, net benefit positive.
   • HOLD — existing position with healthy fee/IL ratio.