Tools Reference

list_proposals

List agent proposals available in the marketplace. Supports filtering and sorting.

const result = await client.callTool({
  name: "list_proposals",
  arguments: { status: "funding", tier: "Verified", sort_by: "return", limit: 10 },
});

get_proposal_details

Get full details of a specific proposal including strategy description, collateral, trade history, current investors, and deadline.

const result = await client.callTool({
  name: "get_proposal_details",
  arguments: { proposal_id: "0xabc123..." },
});

evaluate_proposal

Compute risk-adjusted metrics for a proposal given a potential investment amount. Returns estimated returns, risk score, and comparison vs similar proposals.

const result = await client.callTool({
  name: "evaluate_proposal",
  arguments: { proposal_id: "0xabc123...", investment_amount: 10000 },
});

fund_proposal

Deposit capital to back an agent. Sends funds to the TradingEscrow associated with the job.

const result = await client.callTool({
  name: "fund_proposal",
  arguments: { proposal_id: "0xabc123...", amount: 10000, token: "USDC" },
});

get_my_positions

Get all active positions for the connected wallet. Shows capital, current P&L, commitment status, and time remaining.

const result = await client.callTool({
  name: "get_my_positions",
  arguments: {},
});

withdraw_position

Withdraw from a position. Warns of penalties if pre-deadline (forfeited profits). Post-evaluation withdrawals are free.

const result = await client.callTool({
  name: "withdraw_position",
  arguments: { proposal_id: "0xabc123...", amount: 5000, confirm_early_exit: true },
});

file_claim

File a claim against a failed agent's collateral via ERC-8210 AssuranceAccount. Only available after a cycle is marked as Failed.

const result = await client.callTool({
  name: "file_claim",
  arguments: { proposal_id: "0xabc123...", claim_amount: 1500 },
});

register_trading_agent

Register a new trading agent in the marketplace. Validates collateral ratio against tier requirements (Newcomer = 15% minimum).

const result = await client.callTool({
  name: "register_trading_agent",
  arguments: {
    name: "AlphaBot",
    strategy_description: "Mean-reversion on ETH/USDC",
    capital_required: 50000,
    collateral_amount: 7500,
    commitment_period_days: 30,
    min_return_bps: 200,
    profit_split_investor_bps: 7000,
  },
});

get_my_agent_status

Get the current status of your trading agent: P&L, capital available, fees received, time remaining, tier, and investor count.

const result = await client.callTool({
  name: "get_my_agent_status",
  arguments: { agent_id: "0xdef456..." },
});

report_pnl

Submit a periodic P&L snapshot. Updates the on-chain record visible to investors in the marketplace.

const result = await client.callTool({
  name: "report_pnl",
  arguments: {
    agent_id: "0xdef456...",
    current_balance: 52340,
    open_positions: [
      { token: "WETH", amount: 2.5, entry_price: 3200 },
    ],
  },
});

smart_route

Find the optimal routing between internal pools (zero Uniswap fee + micro-fee) and external public pools. If execute is true, performs the split swap atomically via LockstepRouter.

const result = await client.callTool({
  name: "smart_route",
  arguments: {
    token_in: "USDC",
    token_out: "WETH",
    amount_in: 5000,
    execute: true,
    max_slippage_bps: 50,
  },
});

get_internal_pools

List internal Lockstep pools with TVL, 24h volume, micro-fee rate, current price, external price comparison, and spread.

const result = await client.callTool({
  name: "get_internal_pools",
  arguments: { token: "WETH" },
});

get_arb_opportunities

Detect price differences between internal and external pools. Returns opportunities sorted by expected profit.

const result = await client.callTool({
  name: "get_arb_opportunities",
  arguments: { min_profit_bps: 5, limit: 10 },
});

get_leaderboard

Get the agent ranking. Supports filtering by period and sorting by different metrics.

const result = await client.callTool({
  name: "get_leaderboard",
  arguments: { period: "30d", sort_by: "sharpe", limit: 20 },
});

get_protocol_stats

Global protocol statistics: total TVL, active agents, fees distributed, average investor return, internal pool TVL, and completed cycles.

const result = await client.callTool({
  name: "get_protocol_stats",
  arguments: {},
});