Autonomous Strategies

​

Overview

​

Strategy Types

​

Price Alert

• Stop-loss: Sell your position if the price drops below a level to limit losses
• Take-profit: Sell when the price reaches your target to lock in gains
• Limit buy: Buy into a market once the price dips to a level you find attractive

1. You specify a token, a trigger condition (PRICE_LTE or PRICE_GTE), and a trigger price
2. The server checks the price every ~10 seconds
3. When the condition is met, it places the order immediately
4. The strategy completes after firing (one-shot)

{
  "type": "PRICE_ALERT",
  "config": {
    "tokenId": "0xabc...",
    "side": "SELL",
    "triggerCondition": "PRICE_LTE",
    "triggerPrice": 0.35,
    "size": 100,
    "orderType": "MARKET"
  },
  "maxBudget": 50
}

​

Recurring Buy

• Steady accumulation: Gradually build a position in a market you’re bullish on
• Crypto markets: Use with marketQuery to automatically find the current active market (handles Polymarket’s expiring 15-min, hourly, and daily crypto markets)
• Risk reduction: Avoid buying everything at a single price point

1. You specify how much to buy and how often (e.g., $10 every hour)
2. Each interval, the server places a market buy order
3. If using marketQuery, the server auto-discovers the currently active market matching your search
4. Continues until maxTotalAmount is reached, the strategy budget is exhausted, or you cancel it

{
  "type": "RECURRING_BUY",
  "config": {
    "marketQuery": "bitcoin",
    "outcome": "Yes",
    "amountPerInterval": 10,
    "intervalMs": 3600000,
    "maxTotalAmount": 200,
    "priceLimit": 0.70
  },
  "maxBudget": 200
}

​

Buy Low Sell High

• Mean reversion: Profit from markets that tend to bounce between two price levels
• Volatility harvesting: Capture gains from markets with predictable ranges
• Automated swing trading: Buy low, sell high, repeat

1. You define a buyBelow floor and a sellAbove ceiling
2. When the price drops to or below buyBelow, the server buys
3. After buying, it waits for the price to rise to or above sellAbove, then sells
4. The cycle repeats until you cancel the strategy or it hits maxOpenSize

{
  "type": "BUY_LOW_SELL_HIGH",
  "config": {
    "tokenId": "0xabc...",
    "buyBelow": 0.40,
    "sellAbove": 0.60,
    "sizePerTrade": 50,
    "maxOpenSize": 200
  },
  "maxBudget": 500
}

​

Copy Trading

• Follow top traders: Copy a successful trader’s positions as they execute
• Mirror a fund: Replicate the trades of a known wallet systematically
• Social trading: Follow a friend’s strategy without manual effort

1. You provide the target wallet address to copy
2. LuckyLobster subscribes to on-chain ERC1155 transfer events on Polymarket’s CTF contract, filtered to that wallet
3. When the target buys or sells, the server detects it in ~2 seconds (Polygon block time)
4. A copy order is placed immediately via the CLOB with your configured sizing
5. Each copied trade is logged and deduplicated to prevent double-execution

{
  "type": "COPY_TRADE",
  "config": {
    "targetAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "sizingMode": "fixed",
    "fixedAmount": 10,
    "copySells": true,
    "maxPositionSize": 500
  },
  "maxBudget": 500
}

{
  "type": "COPY_TRADE",
  "config": {
    "targetAddress": "0x1234567890abcdef1234567890abcdef12345678",
    "sizingMode": "proportional",
    "proportionPct": 50,
    "copySells": true,
    "maxPositionSize": 1000
  },
  "maxBudget": 1000
}

​

Strategy Lifecycle

​

Budget Controls

• The strategy tracks its own budgetUsed counter
• Orders that would exceed the budget are rejected
• When budgetUsed >= maxBudget, the strategy status changes to COMPLETED

​

Managing Strategies

​

From the Dashboard

• Pause an active strategy to temporarily stop execution
• Resume a paused or errored strategy
• Cancel a strategy to permanently stop it
• View execution history, budget usage, and current config

​

From the API

# Create a strategy
POST /api/agent/v1/strategies

# List strategies (with optional filters)
GET /api/agent/v1/strategies?status=ACTIVE&type=RECURRING_BUY

# Get strategy details (includes last 20 executions)
GET /api/agent/v1/strategies/{id}

# Update config or budget
PATCH /api/agent/v1/strategies/{id}

# Pause / Resume / Cancel
POST /api/agent/v1/strategies/{id}/pause
POST /api/agent/v1/strategies/{id}/resume
DELETE /api/agent/v1/strategies/{id}

​

Best Practices

​

Limits