DAO Governance API for AI Agents

AI Agents as DAO Participants

DAOs (Decentralized Autonomous Organizations) govern trillions of dollars in on-chain assets through token-based voting. Protocol upgrades, treasury allocations, parameter changes, and risk framework adjustments all flow through governance — and historically, most token holders simply do not vote.

AI agents change this equation fundamentally. An agent can monitor all active proposals across dozens of DAOs simultaneously, analyze each proposal's economic implications using an LLM, and cast votes within seconds of a proposal going live. Agents represent stakeholders around the clock, in every time zone, without fatigue.

Purple Flea's governance API gives your agent complete DAO participation capabilities: read proposals, analyze with any LLM, delegate tokens, cast votes on-chain or via Snapshot's gasless off-chain system, and submit new proposals.

Supported Governance Platforms

Purple Flea integrates with every major governance framework, covering the full spectrum from gasless off-chain voting to fully on-chain executable governance.

Governance Operations

Purple Flea exposes the complete governance lifecycle as simple API calls. Every operation is chain-aware — the same method works whether you're voting on Compound (Ethereum), Uniswap (Ethereum), or a custom Governor deployment on any EVM chain.

• getProposals Fetch all active proposals for a DAO with full text, vote counts, quorum status, and time remaining
• getProposal Get full proposal details including description text, calldata, proposer, and current state
• castVote Vote for (1), against (0), or abstain (2) on any proposal with optional reason string
• delegateTokens Delegate voting power to another address (including self-delegation to activate votes)
• submitProposal Create a new governance proposal with targets, values, calldatas, and description
• getVotingPower Query current and historical voting power at any block number
• snapshotVote Cast gasless off-chain votes on Snapshot spaces with EIP-712 signatures

Agent Governance Use Cases

1. Portfolio Manager Agent — DeFi DAO Voting

An agent managing a yield-focused portfolio holds governance tokens in multiple DeFi protocols — COMP, UNI, AAVE, CRV. Rather than letting those tokens sit idle, the agent monitors all four DAOs for active proposals, uses an LLM to analyze each proposal's impact on LP yields and protocol risk, and votes automatically according to a pre-configured preference framework (e.g., "always vote for security improvements, vote against fee reductions below 0.05%").

The agent runs as a background process, checking for new proposals every 30 minutes. When a proposal enters voting period, the agent analyzes it within 60 seconds and casts a vote — capturing governance participation that would otherwise be lost to voter apathy.

2. DAO Treasury Management Agent

A treasury management agent operates as an authorized multi-sig signer for a DAO's financial operations. It monitors cash flow, proposes budget reallocations when reserves drop below threshold, and executes approved treasury actions automatically.

When the DAO votes to approve a grant or investment, the treasury agent detects the successful proposal, waits for the timelock period, and queues the execution transaction — ensuring approved decisions are executed promptly without requiring manual intervention from human contributors.

3. Delegated Voting — Token Holders Delegate to AI Agents

Token holders who lack time or expertise to evaluate proposals can delegate their voting power to a specialized AI agent. The agent accepts delegations, maintains a transparent voting record on-chain, and publishes vote rationales for delegators to review.

This creates a new class of AI-powered governance delegates — more consistent and responsive than human delegates, with full auditability of every decision.

import PurpleFlea from "@purpleflea/sdk";
import Anthropic from "@anthropic-ai/sdk";

const pf = new PurpleFlea({ apiKey: process.env.PURPLEFLEA_API_KEY });
const claude = new Anthropic();

// Fetch all active proposals from Compound Governor
const proposals = await pf.governance.getProposals({
  protocol: "compound",
  state: "active",
});

for (const proposal of proposals) {
  // Analyze with Claude
  const analysis = await claude.messages.create({
    model: "claude-opus-4-6",
    max_tokens: 512,
    messages: [{
      role: "user",
      content: `Analyze this governance proposal and recommend how to vote.
        Vote FOR if: improves security, increases yield for LPs, reduces risk.
        Vote AGAINST if: reduces protocol fees significantly, increases risk.

        Proposal: ${proposal.description}

        Respond with JSON: { vote: "for"|"against"|"abstain", rationale: string }`,
    }],
  });

  const { vote, rationale } = JSON.parse(analysis.content[0].text);
  const voteValue = { for: 1, against: 0, abstain: 2 }[vote];

  // Cast vote on-chain
  await pf.governance.castVote({
    protocol: "compound",
    proposalId: proposal.id,
    support: voteValue,
    reason: rationale,
  });

  console.log(`Voted ${vote} on proposal #${proposal.id}: ${rationale}`);
}

// Self-delegate to activate voting power (required for many Governor contracts)
await pf.governance.delegateTokens({
  chain: "ethereum",
  token: "COMP",
  delegatee: pf.wallet.address, // self-delegate
});

// Vote on a Snapshot proposal (gasless)
const snapshotProposals = await pf.governance.getProposals({
  protocol: "snapshot",
  space: "uniswapgovernance.eth",
  state: "active",
});

for (const p of snapshotProposals) {
  await pf.governance.snapshotVote({
    proposalId: p.id,
    choice: 1,  // 1 = first choice option
    reason: "Supporting improved fee tier structure",
  });
}

// Submit a new governance proposal
await pf.governance.submitProposal({
  protocol: "compound",
  targets: ["0xComptrollerAddress"],
  values: [0],
  calldatas: [encodedSetCollateralFactor],
  description: "Adjust ETH collateral factor from 82% to 85% given improved oracle reliability",
});

On-Chain vs Off-Chain Voting: Tradeoffs

Governance frameworks split into two major categories, each with distinct tradeoffs for AI agents. Purple Flea handles both transparently.

Related Purple Flea APIs

Combine DAO governance with treasury management, smart contracts, and cross-agent coordination.