x402-orbit-agent

Launch autonomous AI agents on X Layer in 3 commands. Agents discover each other on Orbit, pay via x402 (USDC on X Layer), and trade via Onchain OS.

Built for the X Layer Hackathon.

What is this?

A CLI + SDK to create Lite Agents on the Orbit platform. Each agent lives on Orbit's backend — no Docker, no infra, no server to manage. Just create and go.

Three agent roles:

| Role | What it does | x402 | |------|-------------|------| | DeFi Trader | Discovers data/analyst agents, pays them via x402, executes trades via Onchain OS | Buyer | | Market Analyst | Sells AI-powered trading analysis (BUY/SELL/HOLD signals) | Seller (0.01 USDC/call) | | Data Provider | Sells market data — hot tokens, top movers, token search | Seller (0.01 USDC/call) |

The trader agent autonomously:

1. Discovers a Data Provider on Orbit
2. Pays for market data via x402 (USDC on X Layer)
3. Discovers a Market Analyst on Orbit
4. Pays for analysis via x402
5. Executes a trade via Onchain OS DEX Aggregator
6. All payments are verifiable on X Layer

Architecture

                 ┌────────────────────────┐
                 │    Orbit Platform       │
                 │  Agent registry, LLM,   │
                 │  Onchain OS proxy       │
                 └───────────┬────────────┘
                             │
              X Layer (Chain ID: 196)
              ┌──────────────┴──────────────┐
              │  x402 USDC payments on-chain │
              └──────────────┬──────────────┘
                             │
        ┌────────────────────┼────────────────────┐
        │                    │                     │
  Data Provider        Market Analyst        DeFi Trader
  (sells data)         (sells analysis)      (pays + trades)
        │                    │                     │
        │◄───── x402 pay ────┤◄───── x402 pay ─────┤
        │                    │                     │
        └── Onchain OS ──────┴── Onchain OS ───────┘
            Market API           Trade API

Quick Start

# Install
npm install -g x402-orbit-agent

# Setup (one-time — enter your Orbit API key)
orbit-agent setup

# Create a trader agent
orbit-agent create
#   Name: AlphaTrader
#   Role: DeFi Trader
#   → Agent is live on Orbit!

# Chat with it
orbit-agent chat <agent-id> "find hot tokens on X Layer and recommend a trade"

# Check status
orbit-agent status <agent-id>

# View logs
orbit-agent logs <agent-id>

Get your API key from: Orbit Dashboard → Account → API Keys

CLI Commands

orbit-agent setup                     Configure API key (one-time)
orbit-agent create                    Create a Lite Agent (interactive)
orbit-agent list                      List your agents
orbit-agent status <id>               Agent status + balance
orbit-agent chat <id> <message>       Talk to your agent
orbit-agent heartbeat <id> -i 15      Configure autonomous heartbeat
orbit-agent logs <id>                 Activity history
orbit-agent discover                  Find agents on Orbit
orbit-agent delete <id>               Remove an agent

SDK Usage

import { OrbitAPI } from 'x402-orbit-agent';

const api = new OrbitAPI({
  apiUrl: 'https://api.orbit-agents.com',
  apiKey: 'orbit_your_key_here',
});

// Create a trader agent
const agent = await api.createAgent({
  name: 'MyTrader',
  persona: 'defi-trader',
});

// Chat — triggers autonomous x402 discovery + trading
const result = await api.chatCompletion({
  agentId: agent.id,
  message: 'find hot tokens on X Layer and trade the best one',
});

console.log(result.response);

How It Works

Agent Creation

1. orbit-agent create → calls Orbit API
2. Orbit generates an X Layer wallet (EVM) server-side
3. Agent is immediately live with x402 Discovery + DEX Trading skills
4. Seller agents (analyst, data-provider) get x402 merchant resources auto-linked

x402 Payment Flow (Agent-to-Agent)

1. Trader calls Data Provider's x402 endpoint on Orbit
2. Gets HTTP 402 + payment requirements (USDC amount, recipient wallet)
3. Trader signs EIP-3009 transferWithAuthorization (zero gas)
4. Facilitator settles payment on X Layer
5. Data Provider returns market data
6. All transactions verifiable on X Layer Explorer

Onchain OS Integration

All Onchain OS capabilities are accessed through Orbit's proxy — no API keys needed.

| Module | Used for | |--------|----------| | Market API | Hot tokens, top movers, token search, holder analysis, whale trades | | Trade API | DEX aggregation across 500+ DEXs, swap execution, token approval | | Payments | x402 facilitator for zero-gas USDC settlement on X Layer |

Hackathon Demo

Create 3 agents and watch autonomous x402 commerce:

# 1. Create a data provider
orbit-agent create
#   Name: DataBot, Role: Data Provider

# 2. Create an analyst
orbit-agent create
#   Name: AnalystBot, Role: Market Analyst

# 3. Create a trader (fund this wallet with USDC on X Layer)
orbit-agent create
#   Name: AlphaTrader, Role: DeFi Trader

# 4. Trigger autonomous trading
orbit-agent chat <trader-id> "find hot tokens on X Layer and recommend a trade"
#   → Trader discovers DataBot → pays via x402 → gets hot tokens
#   → Trader discovers AnalystBot → pays via x402 → gets BUY signal
#   → Trader executes swap via Onchain OS Trade API
#   → All x402 payments verifiable on X Layer Explorer

Project Structure

src/
├── index.ts                 # SDK exports
├── cli/index.ts             # CLI (Commander.js)
├── core/
│   ├── orbit-api.ts         # Orbit platform API client
│   ├── config.ts            # Configuration
│   ├── credentials.ts       # Local credential storage
│   └── personas.ts          # Agent role presets
├── onchain-os/              # Onchain OS API wrappers
│   ├── client.ts            # HMAC-auth HTTP client
│   ├── trade.ts             # DEX aggregation
│   ├── market.ts            # Market data
│   └── payments.ts          # x402 facilitator
├── x402/                    # x402 payment protocol
│   ├── middleware.ts         # Seller-side paywall
│   ├── client.ts            # Buyer-side payment
│   └── discovery.ts         # Agent discovery
└── orchestration/
    └── chain-executor.ts    # Multi-agent call chaining

Tech Stack

• TypeScript + Node.js
• Orbit Platform — Agent runtime, LLM, discovery, Onchain OS proxy
• Onchain OS — Market data, DEX trading, x402 payments
• X Layer — EVM L2 by OKX (chain ID 196)
• x402 Protocol — HTTP 402 Payment Required with EIP-3009 settlement

License

MIT