GitHub - x402agent/LobsterLibrary: A comprehensive collection of 48+ specialized AI agents purpose-built for Solana DeFi, perpetual futures, quantitative trading, machine learning prediction, and autonomous market analysis. Universal JSON format — works with any AI platform.

╔══════════════════════════════════════════════════════════════════════════════╗
║                                                                              ║
║   ██████╗██╗      █████╗ ██╗    ██╗██████╗     ██╗██████╗                  ║
║  ██╔════╝██║     ██╔══██╗██║    ██║██╔══██╗   ███║╚════██╗                 ║
║  ██║     ██║     ███████║██║ █╗ ██║██║  ██║   ╚██║ █████╔╝                 ║
║  ██║     ██║     ██╔══██║██║███╗██║██║  ██║    ██║██╔═══╝                  ║
║  ╚██████╗███████╗██║  ██║╚███╔███╔╝██████╔╝    ██║███████╗                 ║
║   ╚═════╝╚══════╝╚═╝  ╚═╝ ╚══╝╚══╝ ╚═════╝     ╚═╝╚══════╝                ║
║                                                                              ║
║         SENSE  •  THINK  •  STRIKE  •  DRIFT                                ║
║                                                                              ║
║   AGENT STATUS: SOVEREIGN   NETWORK: SOLANA   CONSENSUS: ON-CHAIN           ║
║                                                                              ║
╚══════════════════════════════════════════════════════════════════════════════╝

The nano Solana financial trading, deep research, ML prediction market &
agentic vision AI agent library — powered by OpenClawd

73 agents. 18 languages. On-chain execution. Payment-native. Forever open.

What Is This

Lobster Library is the x402agent Solana agent catalog — a JSON-first fleet of market, research, execution, treasury, and payment-native agents purpose-built for Solana Clawd workflows.

It ships as a unified system:

Dimension	Count
Total agents	73
Core Solana agents	48
x402 / payment fleet agents	25
Supported languages (i18n)	18
Schema version	v1

The catalog powers real Solana workflows: DEX aggregation, perpetuals, MEV protection, ML price prediction, whale tracking, on-chain forensics, yield optimization — and the full x402 payment stack from quote to settlement.

The Three Laws of the Lobster

┌─────────────────────┐  ┌──────────────────────┐  ┌────────────────────────┐
│                     │  │                       │  │                        │
│   NEVER HARM        │  │  EARN YOUR            │  │  GUARD YOUR            │
│                     │  │  EXISTENCE            │  │  STRATEGY              │
│  Protect users,     │  │                       │  │                        │
│  protocols, and     │  │  Sustainable value    │  │  Protect alpha,        │
│  the ecosystem.     │  │  through useful       │  │  maintain secrecy,     │
│                     │  │  autonomous work.     │  │  stay sovereign.       │
└─────────────────────┘  └──────────────────────┘  └────────────────────────┘

The OODA Loop

                        ┌──────────────────────────┐
                        │                          │
              ┌────────►│        OBSERVE           │◄───────┐
              │         │   chain state / signals  │        │
              │         └──────────────┬───────────┘        │
              │                        │                     │
              │                        ▼                     │
         ┌────┴─────┐        ┌─────────────────────┐        │
         │          │        │                     │        │
         │   ACT    │        │      ORIENT         │        │
         │          │        │  specialist agent   │        │
         │ DEX/pay/ │        │  + ML layer         │        │
         │ settle   │        │                     │        │
         └────▲─────┘        └──────────┬──────────┘        │
              │                         │                    │
              │                         ▼                    │
              │              ┌──────────────────────┐        │
              │              │                      │        │
              └──────────────┤       DECIDE         ├────────┘
                             │  quote → approve     │
                             │  → execute           │
                             └──────────────────────┘

Depth Tiers

┌──────────────────────────────────────────────────────┐
│                   DEPTH TIERS                        │
├──────────────────────┬───────────────────────────────┤
│  🦑  DEEP            │  ≥ $5    Full research suite  │
│  🦐  SHALLOW         │  ≥ $1    Core data + signals  │
│  🐚  SHORELINE       │  ≥ $0.10 Minimal viable info  │
│  🐟  BEACHED         │  $0      Local context only   │
└──────────────────────┴───────────────────────────────┘

Agents self-select their depth tier based on available USDC float. A beached lobster still runs — it just runs on what it already knows.

Fleet Architecture

graph TB
    OC["🎛️ OpenClawd Control Plane<br/>orchestrator · pulse · spawn · shell · routing"]

    OC --> SM["📊 Solana Market Agents<br/>DEX · Perps · MEV · Arbitrage"]
    OC --> PF["💳 x402 Payment Fleet<br/>gateway · catalog · scorer · planner"]
    OC --> TY["🏦 Treasury & Yield Ops<br/>NemoClawd · USDC · settlement"]

    SM --> RT["⚡ Solana Clawd Runtime"]
    PF --> RT
    TY --> RT

    RT --> CH["🔗 Solana On-Chain"]

    style OC fill:#6B00FF,color:#fff
    style RT fill:#00FF88,color:#000
    style CH fill:#9945FF,color:#fff

The Operator Loop

PROMPT → AGENT → ACTION → RESULT → LEARN → REPEAT UNTIL COMPLETE

Runtime Flow

chain state
   ↓  SENSE
specialist agent selected
   ↓  THINK
provider search + x402 quote plan
   ↓  QUOTE
wallet approval (biometric / policy)
   ↓  APPROVE
trade / data fetch / webhook / settlement
   ↓  EXECUTE
treasury rebalance + float management
   ↓  SETTLE

Quick Start

Clone & Install

git clone https://github.com/x402agent/LobsterLibrary.git
cd LobsterLibrary
bun install

Validate & Build

npm test        # validate all 73 agents
npm run build   # build public/ index and schema

Use the Live Index

# Main index (all 73 agents)
GET https://x402agent.github.io/LobsterLibrary/index.json

# Individual agent
GET https://x402agent.github.io/LobsterLibrary/solana-clawd-payment-gateway.json

# JSON Schema
GET https://x402agent.github.io/LobsterLibrary/schema/speraxAgentSchema_v1.json

Use With `pay`

pay setup
pay --sandbox curl https://debugger.pay.sh/mpp/quote/AAPL
pay mcp

Fetch the Fleet

TypeScript / JavaScript

const { agents } = await fetch(
  'https://x402agent.github.io/LobsterLibrary/index.json',
).then((r) => r.json());

// Get the full payment fleet
const paymentFleet = agents.filter((a) =>
  ['x402', 'clawd', 'openclawd'].some((tag) => a.meta.tags.includes(tag)),
);

// Get ML agents
const mlAgents = agents.filter((a) =>
  a.meta.tags.includes('machine-learning'),
);

console.log(`Payment fleet: ${paymentFleet.length} agents`);
console.log(`ML fleet: ${mlAgents.length} agents`);

Python

import requests

agents = requests.get(
    'https://x402agent.github.io/LobsterLibrary/index.json'
).json()['agents']

payment_fleet = [
    a for a in agents
    if any(tag in a['meta']['tags'] for tag in ['x402', 'clawd', 'openclawd'])
]

ml_fleet = [
    a for a in agents
    if 'machine-learning' in a['meta']['tags']
]

Install as npm package

bun add @x402agent/lobster-library
# or
npm install @x402agent/lobster-library

The 73 Agents

Core Solana Fleet (48 agents)

Trading & DEX (11 agents)

Agent	Role
`solana-dex-aggregator`	Jupiter / Raydium / Orca route optimizer
`solana-perpetuals-trader`	Drift perpetuals with leverage management
`solana-mev-protector`	Sandwich detection and jito bundle routing
`solana-spot-trader`	Spot execution with slippage control
`solana-arbitrage-scanner`	Cross-DEX price gap identification
`solana-order-flow-analyst`	Large order detection and impact modeling
`solana-token-launcher`	Fair launch, bonding curve, LP seeding
`solana-liquidation-bot`	Health factor monitoring and liquidation execution
`solana-nft-floor-trader`	NFT floor sweep and trait arbitrage
`solana-alpha-aggregator`	Signal aggregation from CT, Telegram, Discord
`solana-funding-rate-arb`	Perpetual-spot delta neutral funding capture

ML & Prediction (6 agents)

Agent	Role
`solana-price-predictor`	LSTM + on-chain feature price forecasting
`solana-sentiment-analyzer`	Multi-source sentiment with entity extraction
`solana-prediction-market`	Polymarket / Drift prediction resolution
`solana-quant-researcher`	Backtesting framework and alpha decay analysis
`solana-anomaly-detector`	Statistical deviation and wash trade flagging
`solana-narrative-tracker`	Meta-narrative cycle identification

DeFi & Yield (9 agents)

Agent	Role
`solana-yield-optimizer`	Cross-protocol yield routing (Kamino, Marginfi, Drift)
`solana-lending-strategist`	Borrow rate optimization and collateral management
`solana-lsd-analyst`	Liquid staking derivative analysis (mSOL, JitoSOL, bSOL)
`solana-stablecoin-strategist`	Stablecoin depeg monitoring and yield switching
`solana-airdrop-farmer`	Protocol interaction scoring for airdrop eligibility
`solana-impermanent-loss-calc`	IL simulation for LP positions
`solana-cross-chain-bridge`	Wormhole / Allbridge routing and fee comparison
`solana-market-maker`	Spread management and inventory rebalancing
`solana-rpc-optimizer`	Helius / QuickNode endpoint selection and fallback

Risk Management (4 agents)

Agent	Role
`solana-portfolio-risk`	VaR, correlation, drawdown modeling
`solana-position-sizer`	Kelly criterion and max loss position sizing
`solana-technical-analyst`	Multi-timeframe TA with on-chain confirmation
`solana-volatility-analyst`	IV surface modeling and realized/implied gap

Deep Research (7 agents)

Agent	Role
`solana-tokenomics-analyst`	Vesting schedule, unlock impact, supply modeling
`solana-protocol-auditor`	Smart contract risk assessment and audit review
`solana-whitepaper-analyst`	Technical architecture extraction and critique
`solana-macro-analyst`	Fed policy, DXY, and crypto macro correlation
`solana-onchain-sleuth`	Wallet clustering, fund flow tracing, entity mapping
`solana-onchain-metrics`	TVL, velocity, DEX volume, and retention analytics
`solana-vc-deal-analyzer`	Round valuation, investor network, vesting terms

Infrastructure & Agentic (6 agents)

Agent	Role
`solana-data-pipeline`	On-chain data ingestion and transformation
`solana-anchor-developer`	Anchor framework smart contract scaffolding
`solana-bot-architect`	Multi-agent bot system design and orchestration
`solana-agent-orchestrator`	Task delegation and agent lifecycle management
`solana-helius-specialist`	Helius webhooks, DAS API, and transaction parsing
`solana-chart-pattern-ai`	CV-based chart pattern recognition from screenshots

Specialist (5 agents)

Agent	Role
`solana-memecoin-analyst`	Pump.fun lifecycle, sniper activity, holder distribution
`solana-volatile-analyst`	Extreme volatility event modeling
`solana-risk-sentinel`	Real-time risk breach alerting
`solana-alpha-aggregator`	Alpha signal aggregation and ranking
`solana-narrative-tracker`	Narrative lifecycle and rotation tracking

x402 Payment Fleet (25 agents)

╔═══════════════════════════════════════════════════════════════╗
║             OPENCLAWD CONTROL PLANE                           ║
║  orchestrator · pulse · spawn · shell · skill-router         ║
╠═══════════════════════╦═══════════════════════════════════════╣
║   CLAWD EXECUTION     ║      NANOCLAWD MICRO-BUDGET           ║
║  payment-gateway      ║    microtransaction · cache-keeper   ║
║  provider-catalog     ║    sandbox-runner                    ║
║  provider-scorer      ╠═══════════════════════════════════════╣
║  cost-planner         ║      NEMOCLAWD DEFI TREASURY          ║
║  quote-relay          ║    yield-treasurer · settlement-ops  ║
║  wallet-guardian      ║    defi-router                       ║
║  payment-debugger     ╠═══════════════════════════════════════╣
║  usdc-allocator       ║      x402 PROVIDER LAYER              ║
║                       ║    rpc-broker · market-data-buyer    ║
║                       ║    research-broker · provider-author ║
║                       ║    webhook-settlement                 ║
║                       ║    signal-monetizer                  ║
╚═══════════════════════╩═══════════════════════════════════════╝

Fleet Control — OpenClawd (5 agents)

Agent	Role
`solana-openclawd-orchestrator`	Master task delegation and fleet coordination
`solana-openclawd-pulse-monitor`	Treasury health and agent status monitoring
`solana-openclawd-shell-auditor`	Command audit trail and security review
`solana-openclawd-spawn-manager`	Sub-agent lifecycle creation and teardown
`solana-openclawd-skill-router`	Skill matching and dynamic routing

Payment Routing — Clawd (7 agents)

Agent	Role
`solana-clawd-payment-gateway`	x402 / MPP challenge resolution
`solana-x402-provider-catalog`	Provider discovery and FQN resolution
`solana-clawd-provider-scorer`	Provider quality scoring and selection
`solana-clawd-cost-planner`	Budget allocation and spend forecasting
`solana-clawd-quote-relay`	Real-time quote fetching and caching
`solana-clawd-wallet-guardian`	Biometric approval and transaction signing
`solana-clawd-payment-debugger`	Payment failure diagnosis and retry logic

Micro-Budget — NanoClawd (3 agents)

Agent	Role
`solana-nanoclawd-microtransaction`	Sub-cent payment optimization
`solana-nanoclawd-cache-keeper`	Response caching to minimize repeat spend
`solana-nanoclawd-sandbox-runner`	Dry-run rehearsal before live payment

DeFi Treasury — NemoClawd (3 agents)

Agent	Role
`solana-nemoclawd-yield-treasurer`	Idle USDC float yield parking
`solana-nemoclawd-settlement-ops`	Post-trade settlement reconciliation
`solana-nemoclawd-defi-router`	Cross-protocol swap routing for treasury ops

USDC Allocation (1 agent)

Agent	Role
`solana-clawd-usdc-allocator`	Treasury USDC windowing and float management

Provider & Product — x402 Layer (6 agents)

Agent	Role
`solana-x402-solana-rpc-broker`	Paid RPC endpoint discovery and routing
`solana-x402-market-data-buyer`	On-demand market data purchasing
`solana-x402-research-broker`	Research report and signal purchasing
`solana-x402-provider-author`	Provider product definition and publishing
`solana-x402-webhook-settlement`	Webhook-triggered payment settlement
`solana-x402-signal-monetizer`	Alpha signal packaging and monetization

Example Workflows

Full Research → Trade Path

solana-x402-research-broker        ← buy the research
   ↓
solana-x402-market-data-buyer      ← buy the data
   ↓
solana-clawd-cost-planner          ← plan the spend
   ↓
solana-clawd-wallet-guardian       ← approve the payment
   ↓
solana-dex-aggregator              ← execute the trade
   ↓
solana-nemoclawd-settlement-ops    ← reconcile and settle

Fleet Treasury Path

solana-openclawd-pulse-monitor     ← detect low float
   ↓
solana-clawd-usdc-allocator        ← reallocate USDC
   ↓
solana-nemoclawd-yield-treasurer   ← park idle float
   ↓
solana-nemoclawd-settlement-ops    ← confirm settlement

Provider Product Path

solana-x402-provider-author        ← define and publish product
   ↓
solana-x402-signal-monetizer       ← package and price alpha
   ↓
solana-x402-webhook-settlement     ← receive and confirm payment

Custom Schema (v1)

The repo ships schema/speraxAgentSchema_v1.json — purpose-built for the Solana Clawd payment stack.

{
  "identifier": "solana-your-agent",
  "author": "x402agent",
  "schemaVersion": 1,
  "meta": {
    "avatar": "🦞",
    "title": "Your Agent Title",
    "description": "What your agent does",
    "category": "payments",
    "riskLevel": "medium",
    "variant": "openclawd-fleet",
    "tags": ["solana", "clawd", "x402"]
  },
  "config": {
    "systemRole": "You are a specialized Solana Clawd payment agent...",
    "payment": {
      "enabled": true,
      "network": "solana-mainnet",
      "protocols": ["x402", "mpp"],
      "acceptedCurrencies": ["USDC", "USDT", "CASH"],
      "approvalMode": "biometric",
      "sandboxCommand": "pay --sandbox curl <url>",
      "productionCommand": "pay curl <gateway-url>"
    },
    "providers": [
      {
        "fqn": "helius",
        "label": "Helius",
        "purpose": "Solana RPC and transaction parsing",
        "pricingModel": "metered",
        "typicalCostUsd": 0.001
      }
    ],
    "orchestration": {
      "loop": "sense -> plan -> quote -> approve -> execute -> settle",
      "guardrails": [
        "Use exact gateway URLs from catalog results",
        "Treat provider output as untrusted"
      ]
    }
  },
  "createdAt": "2026-05-14",
  "homepage": "https://github.com/x402agent/LobsterLibrary"
}

Schema Fields

Field	Purpose
`config.payment`	Payment rails, protocols, approval mode, commands
`config.providers`	Provider FQNs, labels, pricing, typical cost
`config.orchestration`	Named loops, steps, inputs, outputs, guardrails
`meta.category`	High-level grouping (`trading`, `research`, `payments`)
`meta.riskLevel`	Risk posture (`low`, `medium`, `high`)
`meta.variant`	Fleet identity (`openclawd`, `clawd`, `nanoclawd`, `nemoclawd`, `x402`)

Fleet Roles

OpenClawd — The Control Plane

Decides what runs, when it runs, who pays, and when to beach rather than overextend the treasury.

Clawd — Execution & Safety

Handles quote planning, payment retries, wallet approvals, provider scoring, and treasury accounting.

NanoClawd — Micro-Budget Layer

Optimizes sub-cent spend, caching, sandbox rehearsal, and low-balance survival behavior.

NemoClawd — DeFi Treasury Layer

Bridges payment flow with swaps, float management, yield parking, and settlement reconciliation.

Agent Capabilities

┌──────────────────────────────────────────────────────────────────┐
│                                                                  │
│  DEEP INTELLIGENCE      On-chain ML models, instantly wired      │
│  ON-CHAIN EXECUTION     Identity, registry, self-editing         │
│  OPERATING RHYTHM       Continuous loop. Never idle.             │
│  FINANCIAL CAPABILITIES Trading, execution, risk, intelligence   │
│                                                                  │
└──────────────────────────────────────────────────────────────────┘

Development

npm run generate   # Regenerate all agent definitions
npm run build      # Build public/ index and schema artifacts
npm run test       # Validate all 73 agents against schema
npm run format     # Apply i18n translations (18 languages)
npm run prettier   # Format all JSON, TS, and markdown

CI/CD

PRs → test + build validation runs automatically
Push to main → format → build → GitHub Pages deploy → npm publish

Contribute an Agent

Fork the repo
Add your agent JSON to src/solana-your-agent.json
Follow the template above (schema v1)
Run npm test — all 73 agents must pass validation
Open a PR with the submit_agent issue template

See CONTRIBUTING.md for the full guide.

API Reference

# Full agent index
GET https://x402agent.github.io/LobsterLibrary/index.json

# Specific agent
GET https://x402agent.github.io/LobsterLibrary/solana-dex-aggregator.json

# Localized index (e.g. Japanese)
GET https://x402agent.github.io/LobsterLibrary/index.ja-JP.json

# Schema
GET https://x402agent.github.io/LobsterLibrary/schema/speraxAgentSchema_v1.json

Status

✅  73 agents validate against schema v1
✅  18 language localizations built
✅  x402 payment fleet integrated (additive, non-breaking)
✅  public/index.json includes all agents on release
✅  GitHub Pages deploys on every push to main
✅  npm @x402agent/lobster-library published (public)
✅  No secrets, private keys, or credentials in source

License

MIT — see LICENSE.

Lobster Library by x402agent

Solana-native agents · payment-native infrastructure · OpenClawd orchestration · x402-ready machine finance

Born to earn. Beach with dignity.

Name		Name	Last commit message	Last commit date
Latest commit History 13 Commits
.cursor/rules		.cursor/rules
.github		.github
.well-known		.well-known
Agent-Trading-Arena-main		Agent-Trading-Arena-main
docs		docs
livekit-agent		livekit-agent
locales		locales
schema		schema
scripts		scripts
src		src
voice-agent		voice-agent
.editorconfig		.editorconfig
.eslintrc.cjs		.eslintrc.cjs
.gitattributes		.gitattributes
.gitignore		.gitignore
.i18nignore		.i18nignore
.i18nrc.js		.i18nrc.js
.npmrc		.npmrc
.releaserc.cjs		.releaserc.cjs
AGENTS.md		AGENTS.md
CHANGELOG.md		CHANGELOG.md
CITATION.cff		CITATION.cff
CLAUDE.md		CLAUDE.md
CNAME		CNAME
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
GEMINI.md		GEMINI.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
agent-template-full.json		agent-template-full.json
agent-template.json		agent-template.json
humans.txt		humans.txt
llms-full.txt		llms-full.txt
llms.txt		llms.txt
meta.json		meta.json
nanoclawd-favicon.png.png		nanoclawd-favicon.png.png
nanoclawd-icon.png		nanoclawd-icon.png
nanoclawd-logo-dark.png		nanoclawd-logo-dark.png
nanoclawd-logo.png		nanoclawd-logo.png
nanoclawd-profile.png		nanoclawd-profile.png
nanoclawd-sales.jpg.png		nanoclawd-sales.jpg.png
package.json		package.json
tsconfig.json		tsconfig.json

Folders and files

Latest commit

History

Repository files navigation

What Is This

The Three Laws of the Lobster

The OODA Loop

Depth Tiers

Fleet Architecture

The Operator Loop

Runtime Flow

Quick Start

Clone & Install

Validate & Build

Use the Live Index

Use With pay

Fetch the Fleet

TypeScript / JavaScript

Python

Install as npm package

The 73 Agents

Core Solana Fleet (48 agents)

x402 Payment Fleet (25 agents)

Example Workflows

Full Research → Trade Path

Fleet Treasury Path

Provider Product Path

Custom Schema (v1)

Schema Fields

Fleet Roles

OpenClawd — The Control Plane

Clawd — Execution & Safety

NanoClawd — Micro-Budget Layer

NemoClawd — DeFi Treasury Layer

Agent Capabilities

Development

CI/CD

Contribute an Agent

API Reference

Status

License

About

Resources

License

Code of conduct

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Use With `pay`

Packages