Documentation

Learn how to use Motions for automated trading

Getting Started

1. Connect Your Wallet

Click "Connect Wallet" and authenticate using MetaMask, WalletConnect, or any supported wallet. Sign the verification message to prove ownership.

2. Purchase Access

Pay $599 to unlock 30 days of full access. Amount is charged in the native token of the chain you pay on — ETH on Base, Ethereum or Robinhood; BNB on BSC; SOL on Solana — converted from the $599 anchor at the live spot price at the moment of payment. Or redeem a promo code, including a free 24-hour trial code you can request from support.

3. Generate Wallets

Head to Wallets & Funding, pick a chain, name your batch, and choose how many wallets to spin up (up to 100). Click Generate & Download and your encrypted batch file lands on your machine instantly. Motions never holds your private keys — they live only in your downloaded file, secured by your chosen password using bank-grade AES-256-GCM encryption.

4. Fund Your Wallets

Two ways to fund — pick the one that fits your style:

Manual — withdraw native (SOL / ETH / Base ETH / BNB / MON) from your CEX accounts straight into each wallet. Best when you already have funds on an exchange and want full control.

Privacy Funding via ChangeNOW — pay from any supported chain (Ethereum, Base, BSC, Solana). ChangeNOW delivers native funds to each wallet from independent on-chain liquidity sources, so your wallet pool can't be traced back to one address. Pick a distribution that matches the look you want:

  • Even per wallet — uniform amounts, live total preview
  • Increasing — small wallets first, bigger ones last; reads most organically on-chain
  • Custom amount — set every wallet's size yourself

Fund up to 10 SOL (or equivalent) per wallet, with a small reserve kept aside automatically for transaction gas.

5. Defunding (Withdrawing Back)

When you're done with a launch, the Refund Wallets tab pulls everything back to a single destination of your choice. Upload your batch file, pick the wallets, and choose:

  • Direct send — fast and free (just network gas)
  • Via ChangeNOW — privacy-preserving: destination receives from ChangeNOW's liquidity pool, and you can swap to any token on the way out

Use the ChangeNOW path if you want to keep the same privacy story your launch funding had.

Security & Custody

Your Wallets, Your Keys

Motions is non-custodial. Your trading wallet private keys are generated on the server in memory, encrypted with your password using AES-256-GCM (the same standard banks use), and immediately delivered to you as a download. The server then forgets the keys.

What the Server Holds

  • Public wallet addresses (which are public on-chain anyway)
  • The batch name you chose
  • A link from the batch to your connected wallet

What the Server NEVER Sees or Stores

  • Private keys — not in any database, log, or backup
  • Your encryption password — only you know it
  • Any way to move funds from your trading wallets

Your Batches Are Yours

Every batch is bound to the wallet you connected with, and only that wallet can see it, fund it, or defund it. Access checks run server-side at every endpoint — not just hidden in the UI.

To Move Funds Out

You need three things — and only you have them:

  • Your downloaded encrypted batch file
  • Your encryption password
  • Your connected wallet for the destination

Back up your batch file and remember your password. Those are the only two things that matter — without them, no one (including us) can move your funds.

Trading Strategies

Setting Up a Strategy

  1. Select a Chain - Choose Base, BSC, Ethereum, Robinhood, or Solana from the chain tabs
  2. Select a DEX - Pick from available DEXes (Uniswap, PancakeSwap, Aerodrome, Jupiter, etc.)
  3. Enter Token Address - Paste the contract address (CA) for EVM, or the mint address for Solana
  4. Choose Pattern - Select the chart shape you want — Range, Bull Flag, Step Up, Step Down, Accumulate, Distribute, or Stair Cycle
  5. Set Timing Mode - TWAP (even spacing), Jitter (±30% random), or Chaos (±60% random)
  6. Set Duration - How long the strategy should run (15 minutes to 24 hours)
  7. Set Speed - Interval between trades (10s, 30s, 60s, or custom — minimum 5s)
  8. Buy / Sell Range - Set min/max trade size in native (ETH / BNB / SOL); each trade picks a random amount in this range
  9. Aggression - Low / Medium / High — scales candle sizes (Low = softer, High = harder, Medium = pattern defaults)
  10. Safety Budget (optional) - Cap on total native deployed to buys; once hit, buying stops but balancing continues
  11. Start Trading - Click Start to begin automated execution

Timing Modes

TWAP

Time-Weighted Average Price. Fixed intervals between trades, perfect spacing.

Jitter

±30% randomization on intervals for natural-looking timing. Most common choice.

Chaos

±60% randomization, highly irregular spacing. Maximum unpredictability for stealth trading.

Pattern Types

Each pattern uses mixed buy/sell trades with clustered counter-trades and small bursts to keep candles organic — never pure-green pumps or pure-red dumps. Candle sizes vary across each phase so the chart looks like real participants, not a bot.

Important — read before running on a live token: Motions patterns are designed to make low-volume charts feel organic. The bot's trades are the dominant signal, so the pattern shape lands cleanly. On tokens with significant existing volume, your trades blend into broader market activity and the pattern may not paint as cleanly — other participants can move the price in unintended directions. Always monitor your positions when running on a token with real volume. Be ready to adjust speed, aggression, or stop early if conditions change.

Range

Use this for standard volume — when you just want the chart to look alive without a clear direction. Holds price in a tight band; equal buys and sells keep the chart flat. The default choice for routine activity. Net round-trip.

Bull Flag

Sharp pump (the pole) followed by a gentle drift down (the flag), with a small recovery wave mid-flag for realism. Classic bullish continuation. Net accumulate — the pole's heavy buys outweigh the flag's lighter sells, you end with more tokens.

Step Up

Three uneven pumps separated by flat consolidations. Each step is a different size and each consolidation has a small green spike. Net accumulate.

Step Down

Mirror of Step Up: three uneven dumps separated by flat consolidations, with small red spikes mid-hold. Net distribute.

Accumulate (Wyckoff)

Brief markdown drop, then a long range-bound zone where buys quietly outweigh sells, capped by a final spring up. Mimics the smart-money playbook. Net accumulate.

Distribute (Wyckoff)

Inverse of Accumulate: brief markup, long range with hidden sells, then a final break down. Net distribute.

Stair Cycle

Combined Step Up + Step Down — a mountain shape that accumulates then distributes in a single round-trip. Net round-trip by design.

Night Mode

Hands-off mode. Composes a random sequence of sub-patterns over your duration, each round-tripping to net zero. For nights or times when you need to leave a program running unattended. Reactive: large external buys → counter-sell 80%; large external sells → switch to defensive Range mode for 60 minutes, then resume. Minimum duration: 1 hour.

Volume Mirror

Reactive market-maker. Counters every external buy with an 80% sell, every external sell with an 80% buy. Baseline 50/50 volume between events. Good for hands-off use when you are not at the screen — purely reactive, never deviates. Net round-trip — anchors price while keeping the chart active.

Organic Buy Up — Small Dips / Large Dips / Fast Mode

Self-terminating team accumulation with a 27-phase narrative chart shape. Pumps + dips + ramps + final rip — same shape every run, just scaled to whatever SOL budget you've allocated. Per-wallet 3% supply cap keeps holdings distributed organically.

Three variants — pick on the dashboard:

  • Small Dips — pullbacks run 10-25%. Subtle volatility, mostly upward stair-step. Use for tokens where you want the chart to look like steady accumulation without dramatic shakeouts.
  • Large Dips — same 27-phase shape but every dip is ×1.6 deeper. Pullbacks run 16-40% with a -40% late-stage shakeout. Use when you want a more dramatic chart that still ends net-positive.
  • Fast Mode — a compressed ~10 minute buy-up. Buys and sells still fire throughout, but there is no scripted dip narrative — a fast, near-vertical ramp that deploys the whole budget quickly. Same per-wallet cap and external-buyer pause apply. Use when you want the position built fast rather than a long organic-looking arc.

External-buyer pause: tracks NET external SOL position. OBU stops buying if anyone enters and only resumes when ALL external buyers have fully sold out. Multiple buyers handled correctly — your team won't accidentally stack on someone else's pump.

Auto-scales to any budget: 20 SOL or 1000 SOL run produces the same recognizable chart shape, just at different mcap peaks. Phases use cumulative-net targets so 100% of your budget (minus per-wallet $10 gas reserve) gets deployed by run end.

Tip: run a parallel Range strategy on a separate wallet slice for added background volume. E.g., OBU on 75% wallet share, Range on the remaining 25%.

External Trade Reactions

Every pattern reacts to large external trades to protect your SOL / ETH / Base ETH / BNB / MON and extract value from external pumps. Behavior varies by pattern:

PatternExternal Buy > $200External Sell > $200
Range
Volume MirrorSell 80% of their sizeBuy 80% of their size
Night ModeSell 80% of their sizeSwitch to Range for 60 min, then resume
Bull Flag, Step Up, Step Down, Accumulate, Distribute, Stair CycleSell 50% of their sizePause + cooldown
Organic Buy Up

All reactivity is automatic — no configuration required. Protects your position from adverse external flow while still painting your chosen pattern shape.

Wallet Share

What share of a chain's wallets a slot uses. Lets you run multiple strategies in parallel on the same chain without them stepping on each other. Pick 25% / 50% / 75% / 100% per slot.

Default: 25% per slot — 4 slots × 25% = full pool used, no overlap. If you pick higher on one slot (e.g., 75%), the others get less or are disabled, with a notice explaining why.

Important: two strategies sharing wallets cause real problems — budget tracking diverges, token holdings drift, reactive modes can pause on each other's trades. Wallet Share enforces clean separation.

Aggression

Aggression and the Buy/Sell Range work together but do different jobs:

  • Range bounds every trade — no trade is ever smaller than the min or larger than the max.
  • Aggression controls how much the pattern's heavy phases (pole, pump, spring, break) push against those bounds versus how gentle the lighter phases stay.

Worked example: Range 0.5 – 2.0 SOL on Bull Flag. Pole is "heavy", flag is "light":

AggressionPole (heavy)Flag (light)
Low~1.1 – 1.6 SOL~0.5 – 0.6 SOL
Medium (default)~1.6 – 2.0 SOL~0.5 – 0.8 SOL
High~1.7 – 2.0 SOL~0.5 – 1.0 SOL

The Range stays the same in all three cases. What changes is how aggressively the pattern uses it during heavy phases.

Rule of thumb: set Range based on what trade size looks proportional for your token, then use Aggression to dial the heavy phases up or down without changing your bounds. If the chart looks too quiet, bump Aggression up; if it looks too punchy, bring it down.

Safety Budget

An optional cap on the total native (SOL / ETH / BNB) deployed to buys across this run. The cap counts cumulative spend across all wallets in the pool, not per-wallet — so a 50 SOL Safety Budget on a strategy using 5 wallets means 50 SOL total combined, not 50 SOL each.

Once the cap is reached, the bot stops issuing new buys but still runs sells and the balance phase, so the run ends cleanly. Use it on long durations or fast speeds where total exposure could exceed your intent.

Disabled for Range — round-trip is symmetric, so capping mid-run would leave the sell leg unfunded and break the consolidation. Available on the other 6 patterns.

Wallet Management

The Two-Wallet Model

You have a connected wallet (the one you log in with) and up to 100 trading wallets in named batches. Only the trading wallets execute trades — your main address stays off the trade history.

Generating Wallets

In Wallets & Funding → Create Wallets, name your batch and pick how many wallets to spin up. The encrypted batch file downloads to your machine — Motions never holds your keys, just public addresses for the dashboard to display.

Funding Wallets

Two ways to load your wallets:

  • Manual — withdraw native (SOL / ETH / Base ETH / BNB / MON) from your CEX accounts straight to each wallet address. Use multiple CEXs to vary the funding source.
  • Privacy Funding via ChangeNOW — pay from any supported chain and ChangeNOW delivers funds from independent on-chain liquidity sources. Pick Even, Increasing, or Custom amounts per wallet.

Each wallet keeps a small gas reserve automatically so it can always pay for transaction fees — the bot skips any trade that would dip below the reserve.

Refunding Wallets

When you're done with a launch, the Refund Wallets tab sweeps everything to one destination — direct send for speed, or via ChangeNOW for privacy-preserving exits with optional token conversion (out to USDC, USDT, or any supported native).

Token Approvals (EVM)

On Base / BSC / Ethereum / Robinhood, wallets must approve the Universal Router (via Permit2) to spend each token before trading. Use the Approvals section to batch-approve across all wallets. On Solana this isn't needed — Solana token accounts use a different model and our router handles ATA creation automatically.

Controls

Pause / Resume

Each running strategy has its own pause button. Pausing freezes execution mid-pattern — no new trades are submitted, but the schedule is preserved. Resume picks up from where it left off, including phase position. Use this when you need to step away briefly without restarting from scratch.

Stop

Stop ends a strategy permanently. Any trades in flight will complete, but no new ones are submitted and the strategy's schedule is discarded. Restart it like a new strategy if you want to run it again.

Stop All

The Stop All button in the header stops every running strategy across every chain immediately. Use in case of emergency — wrong token loaded, market conditions changed, you spotted something off. It requires your dashboard PIN to activate so it can't be triggered by accident.

Net Effect by Pattern

End-of-run Token Balance

Every pattern has a built-in net effect — what your token balance looks like at the end of the run. Range, Stair Cycle, Volume Mirror, and Night Mode round-trip back to your starting balance. The accumulating and distributing patterns deliberately end with a different balance.

RangeRound-trip — same balance
Bull FlagAccumulate — pole's heavy buys outweigh the flag's lighter sells, you end with more tokens
Step UpAccumulate — three pumps add more than three holds bleed off
Step DownDistribute — three dumps remove more than three holds rebuild
Accumulate (Wyckoff)Accumulate — designed for it (build position quietly)
Distribute (Wyckoff)Distribute — designed for it (unload without panic-sell appearance)
Stair CycleRound-trip — up leg + down leg cancel out
Night ModeRound-trip — composed sub-patterns each net to zero
Volume MirrorRound-trip — every external buy countered with a sell, every sell countered with a buy
Organic Buy Up (Small or Large Dips)Heavy accumulate — the whole pattern is an organic accumulation arc, ending with your wallets holding the supply you funded into

Pick the pattern based on what you want at the end. Round-trip patterns (Range, Stair Cycle, Night Mode, Volume Mirror) are for chart shape only. Bull Flag, Step Up, and Accumulate add to your position. Step Down and Distribute reduce it. Organic Buy Up is the deepest accumulator — designed for team supply building during a launch.

Logs & History

Live Logs

The Logs page shows real-time activity across all your strategies — every trade attempt, success, skip, and failure. Filter by chain, strategy, or wallet. Useful for diagnosing why a particular trade was skipped (e.g. insufficient gas, slippage exceeded, Safety Budget reached).

Trade History

The History page is a permanent record of every trade your bot has executed: timestamp, chain, wallet, direction, amount, price, tx hash. Click any row to view the on-chain transaction. Use this to reconcile P&L, audit performance, or verify your bot did what you intended.

Quick Trade

Manual Buy / Sell

Quick Trade gives you a one-click buy or sell at any time, on any chain, using your trading wallets. Useful for snipes, manual entries, or topping up positions.

Wallet Selection

  • BUY auto-picks the wallet with the lowest token balance in your batch. This means each buy lands in a different wallet, distributing your position naturally across the pool — no two consecutive buys land on the same wallet unless balances tie.
  • SELL picks a random wallet from the pool. Random selection avoids creating a predictable selling pattern.
  • Manual override: you can pick a specific wallet from the dropdown if you need to buy or sell from a single address — useful for consolidating a position or selling out one wallet.

Buy All

The green BUY ALL button distributes a buy evenly across every funded wallet. Type the total amount you want to spend in the Quick Trade input, then click BUY ALL. Each wallet's allocation is capped at min(share, balance - gas reserve) — partial-funded wallets still contribute their max instead of being skipped.

Confirm modal lets you pick Spread (15-second staggered, cleaner price impact) or Instant (parallel fire). No PIN — confirm step is enough.

Type a deliberately huge totalAmount to use full balance minus gas across all wallets. The min(share, balance-gas) cap auto-handles the math.

Sell All

The red SELL ALL button next to Quick Trade liquidates the slot's token across every wallet that holds it. One transaction per wallet. Two-step confirmation: a warning modal lets you pick Spread (15-second staggered) or Instant (parallel). No PIN — confirm step is enough.

Use it after an accumulating pattern (Bull Flag, Step Up, Accumulate, Organic Buy Up) when you're ready to unload, or as an emergency exit if conditions change. Instant mode causes heavy slippage on small-mcap tokens — only use when speed matters more than price.

Heads-up: Sell All is destructive and there's no undo. If you fire it while a pattern is running, the bot will keep executing its schedule and may try to buy again. Stop the strategy first if you want a clean exit.

Supported DEXes

Base

  • Uniswap V4, V3, V2
  • Aerodrome
  • BaseSwap
  • SushiSwap V3

BSC

  • Uniswap V4
  • PancakeSwap V3, V2
  • BiSwap
  • Thena

Ethereum

  • Uniswap V4, V3, V2
  • SushiSwap V3

Robinhood Chain

  • Uniswap V3, V2

EVM chain — swaps route through the Uniswap Universal Router with Permit2 approvals.

Solana

  • Jupiter (aggregator — routes across Raydium, Meteora, Orca, and more)

Solana trades route through our motions_router on-chain program, which calls Jupiter via CPI. Your trades appear as standard Jupiter aggregator activity in Solscan, with the motions_router program in between — no visible links between trading wallets and no exposed master wallet.

Privacy & Security

Aggregator Routing

All swaps route through a shared router — the Uniswap Universal Router on Base / BSC / Ethereum / Robinhood, and the motions_router program on Solana (which CPIs into Jupiter). On-chain, your trades look like ordinary router usage, hiding the connection between your wallets.

Multi-Wallet Distribution

Trades rotate across your trading wallet pool with varied timing and amounts. No visible on-chain links between wallets — no master-wallet funding traces, no clustered timestamps.

Pattern Realism

Every directional pattern includes 15% counter-trades on average — sells during pumps, buys during dumps — clustered into 2-4 small bursts rather than scattered evenly. This produces realistic 5-minute candle wicks (red candles inside an up-move, green candles inside a down-move) that look indistinguishable from organic trading. Candle sizes also vary within each phase so no two pumps look identical.

Keystore Encryption

All private keys are encrypted at rest using scrypt + AES-256-GCM. Your keystore password is never stored — it's required at startup and held only in memory. Never share your password or .env file.

P&L Tiles & Wallets Dropdown

Top Metrics Bar

Six tiles in the top metrics bar refresh based on the active chain tab: Active, Wallets, Trades, Success, P&L, Volume. Click another chain tab and all six switch to that chain's data.

Chain-level Wallets dropdown

Just below the chain tabs. Click "Wallets · {CHAIN}" to expand a table showing every wallet on that chain with: address, current native balance, cumulative P&L (across every running strategy on that chain that touched the wallet), and trade count. Polls every 5s while open.

Per-slot Wallets dropdown

Inside each running strategy slot. Click "Wallets" to expand a per-wallet view for THAT strategy specifically: address, native balance, current token balance for the strategy's token, P&L, and trade count. Useful for drilling into how a specific run is distributed across wallets.

Volume Bot

What it does

Generates real dollar volume through your target pool by cycling one fresh EOA at a time: buy $X of the token, sell it back to native, next wallet, repeat. Every trade is on-chain, every trade counts as real volume. Sequential (1 wallet in flight) so the tape looks organic — not a swarm of parallel bots.

How you configure it

1. Token contract — paste + Load. We pull the exact pool the volume will flow through, plus its fee tier and liquidity.
2. Chain — same set as Trending.
3. Budget — in native (0.05 / 0.10 / 0.20 ETH on Base, or custom). Bot runs until this budget is spent on gas + pool fee + slippage + Motions's 0.1% fee.
4. Trade size — how much each cycle buys ($10 / $25 / $50 / $100). Bigger trades = fewer cycles = faster completion but each cycle costs more.
5. Cadence — Rapid 10s, Fast 20s, Medium 30s, Slow 60s between trades.

Pool fee detection

When you press Load, we read the pool's actual fee tier from DexScreener (verified against on-chain when we ship the pool.fee() reader). Some pools are 0.05%, most are 0.30%, small-cap pools are often 1%. The volume you'll generate depends heavily on this — we bake the real number into the quote.

What you get

The quote panel shows Volume generated (the outcome — how much real dollar volume your budget produces), You'll spend, and Time. Live-run dashboard shows volume ticking up, $/min rate, cycles completed, DexScreener rank, and the live tx feed.

Why sequential and not parallel

Volume is about the tape looking natural. Parallel batches of buys would look like a coordinated pump. One wallet at a time on a slow cadence looks like organic price discovery. That's why concurrency is locked at 1 for Volume Bot.

Bot Costs & Fees

Pay-per-run, no subscription

Trending Bot and Volume Bot are not part of the Motions $599/30-day Market Maker plan. Anyone can use them without a subscription. You pay once per run: on-chain cost + a small Motions service fee. The fee model is transparent and shown in the quote before you sign.

Trending Bot — $0.02 per transaction

Every cycle = 1 buy + 1 sell = 2 txns × $0.02 = $0.04 Motions fee per cycle. For a run of 500 txns (250 cycles): Motions fee $10. Rest of your budget goes to gas (validators) and negligible amounts to pool fees + slippage on $0.01 micro-buys.

Volume Bot — 0.1% of volume generated

For every $100k of real dollar volume you generate, Motions takes $100. Fair and linear. The rest of your budget goes to the chain: gas to validators, pool fee to LPs (0.05–1% depending on pool), slippage (~1% roundtrip estimate) to the market. Motions never touches your on-chain spend.

How the fee is collected

Upfront. When you press Sign & start, you sign one transaction sending budget + Motions fee to a run-scoped ephemeral wallet we generate for your run. The Motions fee is skimmed to our treasury on the first cycle; the rest funds the run. When the run ends (or you Stop), any residual native is returned to your connected wallet automatically.

Failed sells

If a token has a transfer tax, an anti-bot blacklist, thin liquidity, or gets rugged mid-run, the sell can fail. We retry each failed sell 3× with alternate DEX routes and higher slippage. If 5 sells fail in a row, that's a signal the token is broken — the run auto-halts and notifies you. Any orphaned wallets holding token show up at the end of the run with a Retry button; if that fails too, contact support with your run ID and we'll sweep manually.

Comparison to alternatives

Smithii charges ~$0.029/txn for their trending bots and doesn't have a per-volume model. Motions Trending is $0.02/txn (roughly 30% cheaper) and Volume is 0.1% of volume flat — uncontested at that structure. See /pricing.