🤖 Limit Order Agent

Autonomous trading agents for decentralized finance on AO

Execute limit orders, stop-losses, and DCA strategies without centralized intermediaries

Features • Architecture • Strategies • Getting Started • License

---

⚠️ ARCHIVED PROJECT

This project is archived and no longer maintained. It is provided as-is for educational and reference purposes. No support, updates, or bug fixes will be provided.

Originally developed by Autonomous Finance

---

🌟 Features

📈 Limit Orders Execute trades at your target price or better. Supports partial fills across multiple swaps with eager execution.	🛑 Stop Orders Protect your positions with stop-loss triggers. Choose between market or limit execution when thresholds are hit.
📊 Trailing Stops Dynamic stop prices that follow favorable price movements, automatically locking in profits while limiting downside.	🔄 DCA Strategies Dollar-cost averaging with configurable intervals. Automatically distribute capital across time-based executions.

🏗️ Architecture

┌─────────────────────────────────────────────────────────────────┐
│                        FACTORY PROCESS                          │
│  • Spawns & tracks agents    • Manages subscriptions            │
│  • Stores configurations     • Handles lifecycle events         │
└─────────────────────────────────────────────────────────────────┘
                                  │
                    ┌─────────────┼─────────────┐
                    ▼             ▼             ▼
            ┌───────────┐  ┌───────────┐  ┌───────────┐
            │  AGENT 1  │  │  AGENT 2  │  │  AGENT N  │
            │  Limit    │  │  Stop     │  │  DCA      │
            │  Order    │  │  Order    │  │  Order    │
            └───────────┘  └───────────┘  └───────────┘
                    │             │             │
                    └─────────────┼─────────────┘
                                  ▼
                    ┌─────────────────────────┐
                    │    AMM PRICE FEEDS      │
                    │   (Dexi Subscriptions)  │
                    └─────────────────────────┘

How It Works

1. Factory creates agent processes with specific trading configurations
2. Agents subscribe to real-time AMM price updates
3. When conditions are met, agents autonomously execute trades
4. Upon completion, agents finalize and return funds to the owner

📋 Strategy Components

Limit Order

A limit order fills your trade at a specific price or better:

┌──────────────────────────────────────────────┐
│  Input: 100 TOKEN_A                          │
│  Min Output: 500 TOKEN_B                     │
│  ─────────────────────────────               │
│  ✓ Partial fills supported                   │
│  ✓ Eager execution on favorable prices       │
│  ✓ Optional stop-loss attachment             │
└──────────────────────────────────────────────┘

Stop Order

Triggers when price crosses your threshold:

Type	Behavior
Stop-Market	Immediate swap at current price
Stop-Limit	Places limit order when triggered
Trailing Stop	Dynamic threshold follows price

DCA Order

Automated periodic trading:

Day 1    Day 2    Day 3    Day 4    Day 5
  │        │        │        │        │
  ▼        ▼        ▼        ▼        ▼
┌───┐    ┌───┐    ┌───┐    ┌───┐    ┌───┐
│$20│    │$20│    │$20│    │$20│    │$20│  = $100 total
└───┘    └───┘    └───┘    └───┘    └───┘

🔄 Agent Lifecycle

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  CREATION   │────▶│   DEPOSIT   │────▶│ SUBSCRIPTION│
│             │     │             │     │             │
└─────────────┘     └─────────────┘     └─────────────┘
                                               │
       ┌───────────────────────────────────────┘
       ▼
┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│    READY    │────▶│  SWAPPING   │────▶│  FINALIZED  │
│  Monitoring │     │  Executing  │     │  Complete ✓ │
└─────────────┘     └─────────────┘     └─────────────┘

States

State	Description
AwaitingStrategyConfiguration	Initial state after creation
AwaitingDeposit	Waiting for user to fund the agent
AwaitingSubscription	Waiting for price feed subscription
Ready	🟢 Active and monitoring for trade conditions
Swapping	🔄 Currently executing a swap
Complete	✅ Strategy successfully completed
Expired	⏰ Order expired before completion
Canceled	❌ User cancelled the order
EmergencyExited	🚨 Emergency withdrawal executed

🚀 Getting Started

Prerequisites

• Lua 5.4.6
• LuaRocks (package manager)
• Teal 0.15.3 (typed Lua)
• Cyan 0.3.1 (Teal build tool)
• amalg (Lua bundler)
• Node.js 18+ (for tooling)

Installation

# Clone the repository
git clone https://github.com/Autonomous-Finance/limit-order-agent.git
cd limit-order-agent

# Install Node dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

Build Output

The build process produces:

• build/agent.lua - Bundled agent process code
• build/factory.lua - Bundled factory process code (includes agent source)

📁 Project Structure

limit-order-agent/
├── 📂 src/
│   ├── 📂 agent/              # Agent process implementation
│   │   ├── agent.tl           # Main agent module
│   │   ├── swaps.tl           # Swap execution logic
│   │   └── 📂 strategies/     # Strategy implementations
│   │       ├── limit-order.tl
│   │       ├── stop-order.tl
│   │       ├── dca-order.tl
│   │       └── 📂 primitives/ # Composable building blocks
│   ├── 📂 factory/            # Factory process implementation
│   │   ├── factory.tl         # Main factory module
│   │   ├── queries.tl         # Database queries
│   │   └── sqlschema.tl       # SQLite schema
│   ├── 📂 utils/              # Shared utilities
│   └── 📂 typedefs/           # Type definitions
├── 📂 test/                   # Unit tests
│   ├── 📂 mocked-env/         # Mock AO environment
│   └── unit_test_*.lua        # Test suites
├── 📂 scripts/                # Build & test scripts
└── 📂 packages/               # External packages

⚙️ Configuration

Agents are configured through process tags when spawned:

Tag	Description	Required
Amm	AMM process ID for trading	✅
Token-From	Input token process ID	✅
Token-To	Output token process ID	✅
Input	Amount of input token	✅
Expires-At	Expiration timestamp	✅
Order-Owner	Owner wallet address	✅

Strategy-Specific Tags

Limit Order

Tag	Description
Min-Output	Minimum acceptable output amount
Stop-Price	(Optional) Stop-loss trigger price

Stop Order

Tag	Description
Stop-Price	Price threshold to trigger execution
Is-Stop-Limit	true for limit execution, false for market
Is-Trailing	true for trailing stop functionality
Trailing-Difference	Basis points for trailing distance

DCA Order

Tag	Description
Run-Time	Total duration for DCA execution
Tick-Interval	(Optional) Custom interval between swaps

🛠️ Tech Stack

Technology	Purpose
Teal	Typed Lua for safer code
AO	Decentralized compute on Arweave
Cyan	Teal project build tool
Busted	Lua testing framework
SQLite	Embedded database for factory

⚠️ Disclaimer

This software is provided "as is" without warranty of any kind. Use at your own risk. The authors are not responsible for any financial losses incurred through the use of this software.

This is experimental DeFi software. Always:

• Test with small amounts first
• Understand the risks of AMM trading
• Review the code before deploying with real assets

📄 License

This project is licensed under the MIT License - see the LICENSE.md file for details.

---

Originally developed with ❤️ by Autonomous Finance

Building the future of autonomous finance on Arweave