Build a Trading Agent

git clone https://github.com/limitless-labs-group/agents-starter.git
cd agents-starter
npm install
npm run init        # creates .env (mode 600) and lists the credentials to add

npm run doctor                      # key, token, wallet mode, USDC and ETH balances
npm run doctor -- --market <slug>   # plus USDC and CTF approvals for that market's exchange

npm run certainty-closer            # dry run by default
DRY_RUN=false npm run certainty-closer   # live, once the dry-run log looks right

import { BaseStrategy, type StrategyDeps, type StrategyConfig, type TradeDecision, type StrategyStats } from '../base-strategy.js';
import { toFraction } from '../../core/limitless/types.js';

export class MyStrategy extends BaseStrategy {
  constructor(config: StrategyConfig, deps: StrategyDeps) {
    super(config, deps);
    this.tickIntervalMs = 30_000;
    this.awaitFills = true; // block on taker orders until they settle (honors the taker delay)
  }

  async initialize() {}   // connect feeds, load state

  async tick(): Promise<TradeDecision[]> {
    const markets = await this.limitless.getActiveMarkets({ tradeType: 'clob', limit: 25 });
    return markets
      .filter((m) => this.fairValue(m) - toFraction(m.prices?.[0]) > 0.1)
      .map((m) => ({
        action: 'BUY',
        marketSlug: m.slug,
        side: 'YES',
        amountUsd: 1,
        priceLimit: Math.round(toFraction(m.prices?.[0]) * 100) + 2,
        orderType: 'FOK',
        reason: 'fair value above market',
      }));
  }

  async shutdown() {}     // cancel quotes, close feeds
  getStats(): StrategyStats { return { activePositions: 0, totalVolumeUsd: 0, pnlUsd: 0, lastTickDurationMs: this.lastTickDurationMs }; }

  private fairValue(market: { prices?: number[] }): number {
    return toFraction(market.prices?.[0]); // your signal goes here
  }
}