SAM Terminal

Automation Framework for Onchain Trading

A plugin-based trading framework for your AI agents. Build OpenClaw agents that fetch fresh Clanker and Bankr tokens, execute swaps, track wallet activity, manage portfolios, and automate onchain trading strategies.

$ git clone https://github.com/0xtinylabs/samterminal.git_
Get Started
Bankr DEX Screener Anthropic Ethereum OpenClaw

// features

{ }

Plugin Architecture

Modular plugin system with lifecycle hooks and dependency injection. Compose trading strategies from swap, price feed, and wallet plugins.

▶

Runtime Engine

Scheduled trading tasks, cron-based strategies, state persistence, and graceful shutdown. Production-ready from day one.

->

Workflow Engine

DAG-based trading workflow orchestration. Chain price checks, swap execution, and portfolio rebalancing with conditional logic.

⚙

MCP Server

40+ tools across 9 categories. Connect your agent to Claude, Cursor, or any MCP-compatible AI assistant out of the box.

⚡

Token Discovery

Real-time Clanker polling and Bankr on-chain event listening. Auto-discover new tokens on Base, set condition-based strategies, and execute trades the moment your criteria are met.

✎

OpenClaw Skills

Teach your agent new abilities with OpenClaw skill files. AI assistants learn how to run, configure, and operate your project autonomously.

// architecture

architecture.md
Client Layer
CLI MCP Server OpenClaw Playground Your App
Core Layer
Engine Flow Plugins Chains
Plugin Layer
AI Telegram Swap TokenData WalletData
Services Layer
NestJS (TS) Go Services gRPC
TypeScript 5.7+ Go 1.24+ Node.js 18+ gRPC PostgreSQL Prisma

// quick-start

terminal
01$ git clone https://github.com/0xtinylabs/samterminal.git
02$ cd samterminal && cp .env.example .env
03# Edit .env with your API keys (Alchemy, Moralis, etc.)
04$ docker compose -f docker-compose.dev.yml up -d
05$ pnpm install && pnpm proto:gen && pnpm build
06$ make db-migrate
07$ pnpm dev

Full monorepo with gRPC services, Docker, and database. For contributors and self-hosted deployments.

// docs

Getting Started

Set up your first SAM Terminal agent in minutes. Install, configure, and run.

read →

MCP Setup Guide

Connect your agent to Claude, Cursor, or any MCP-compatible AI assistant.

read →

Building Trading Agents

Create autonomous agents that execute on-chain trading strategies.

read →

OpenClaw Skills

Teach AI assistants to operate your project autonomously with skill files.

read →

OpenClaw Trading Automation

Turn your AI agent into an onchain trading machine. Setup, workflows, and best practices.

read →

Real-Time Token Discovery

Auto-discover Clanker and Bankr tokens on Base. Build condition-based strategies from detection to execution.

read →
all docs →