# GET /dao/proposal: $0.01 per call

One DAO governance proposal in full, from its Snapshot id: title, dates, vote shares, leader, voters, quorum, forum link, plus a plain-English AI brief of what it would change and what a voter should weigh. Proposal ids come from dao-proposals or dao-active. ai=false skips the AI part. No voter or author addresses.

- **Price:** $0.01 in USDC, the same on Base, Solana, Polygon, Arbitrum. Failed calls are never charged.
- **Free trial:** yes, 20 free calls a day from Claude, Cursor or any MCP client ([set-up](/mcp/setup)).
- **Tier:** live
- **Answers cached for:** 10 min
- **Data sources:** Snapshot governance API (free); Workers AI: Mistral Small 3.1 for the brief (metered)
- **Lane:** Web3 data ([OpenAPI](/openapi/web3-data.json))
- **Live health:** [status page](/status)

## Free sample

See an answer for the demo input first, free (no payment, 10 a minute): [https://aayatai.com/sample/dao-proposal](/sample/dao-proposal). It is a stored real answer when we have one, otherwise an example marked `"kind": "illustrative"`.

```bash
curl "https://aayatai.com/sample/dao-proposal"
```

## 1. See the price (free)

Call it without paying: you get `402 Payment Required` and a `PAYMENT-REQUIRED` header with the exact price and where to pay.

```bash
curl -i "https://aayatai.com/dao/proposal?id=0xa11332c5c326f34fd4d252853378f0041c4baf6a92094a2dbe91ac5c6ad855d9"
```

## 2. Pay and call (TypeScript)

```bash
npm install @x402/fetch @x402/evm viem
```

```ts
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";

// A wallet used only by your agent, holding a little USDC on Base.
const account = privateKeyToAccount(process.env.WALLET_PRIVATE_KEY as `0x${string}`);
const pay = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});

const res = await pay("https://aayatai.com/dao/proposal?id=0xa11332c5c326f34fd4d252853378f0041c4baf6a92094a2dbe91ac5c6ad855d9");
console.log(await res.json());
```

## 3. Or as an MCP tool

```ts
// MCP server: https://aayatai.com/mcp (Streamable HTTP). With the x402 MCP client (see /start):
const result = await client.callTool("dao-proposal", {"id":"0xa11332c5c326f34fd4d252853378f0041c4baf6a92094a2dbe91ac5c6ad855d9"});
```

## Inputs

- `id` **(required)** (string): Snapshot proposal id (0x... or a space-specific id).
- `ai` (boolean; default `true`): Add the AI brief (default true); false = Snapshot data only.
- `detail` (string; one of `full`, `brief`; default `full`): brief = key fields only (same price)

Bad inputs are rejected with HTTP 400 before any payment is asked for.

## Example answer

Example only: the shape of an answer, with placeholder addresses and made-up figures. It is not data about any real token or wallet; call the service (or its free sample) for real results.

```json
{
  "id": "0xa11332c5c326f34fd4d252853378f0041c4baf6a92094a2dbe91ac5c6ad855d9",
  "title": "Rotate Sentinel Addresses on the DUNI-Owned Uniswap Earn Vaults",
  "state": "closed",
  "start": "2026-09-17T10:45:51.000Z",
  "end": "2026-09-22T10:45:51.000Z",
  "type": "basic",
  "voters": 383,
  "choices": [
    {
      "choice": "For",
      "votes": 18218613.12,
      "sharePct": 100
    },
    {
      "choice": "Against",
      "votes": 0.03,
      "sharePct": 0
    },
    {
      "choice": "Abstain",
      "votes": 0,
      "sharePct": 0
    }
  ],
  "leading": "For",
  "quorum": 10000000,
  "quorumReached": true,
  "summary": "Rotate the sentinel addresses on the vaults owned by DUNI...",
  "link": "https://snapshot.box/#/s:uniswapgovernance.eth/proposal/0xa11332c5c326f34fd4d252853378f0041c4baf6a92094a2dbe91ac5c6ad855d9",
  "space": {
    "id": "uniswapgovernance.eth",
    "name": "Uniswap"
  },
  "discussion": "https://gov.uniswap.org/t/rotate-sentinel-addresses/25000",
  "bodyChars": 2400,
  "aiBrief": {
    "summary": "Replaces the sentinel addresses that can pause the DUNI-owned Uniswap Earn vaults.",
    "changes": [
      "New sentinel addresses take over the pause role on the vaults."
    ],
    "forVoters": [
      "Who controls the new addresses, and whether the change was reviewed."
    ]
  },
  "model": "@cf/mistralai/mistral-small-3.1-24b-instruct",
  "source": "Snapshot"
}
```

## Related

- [GET /protocol/fees](/services/protocol-fees) ($0.003): What a DeFi protocol earns: fees paid by its users and the protocol's own revenue over the last 24 hours, 7 days, 30 days, a year and all time, the day-on-day c
- [GET /protocol/fees/top](/services/protocol-fees-top) ($0.003): Which crypto protocols earn the most: a ranking by fees paid by users or by the protocol's own revenue over 24 hours, 7 days or 30 days, optionally for one chai
- [GET /chain/stats](/services/chain-stats) ($0.003): One blockchain's economy in one call: total value locked, DEX trading volume (24 h, 7 d, 30 d and the day-on-day change), its five busiest DEXs, fees paid on th
- [GET /chain/rank](/services/chain-rank) ($0.002): Blockchains ranked by total value locked in DeFi or by US-dollar stablecoins circulating on them, with both figures and each chain's gas-fee currency symbol (e.
- [GET /dex/top](/services/dex-top) ($0.003): The busiest decentralised exchanges: DEXs ranked by trading volume over 24 hours, 7 days or 30 days, across all chains or on one chain (e.g.
- [GET /dao/search](/services/dao-search) ($0.001): Find a DAO's Snapshot space by name: returns matching spaces, biggest first, with their id (to use with dao-proposals), whether Snapshot has verified them, foll
- [GET /dao/active](/services/dao-active) ($0.002): What DAOs are voting on right now: open Snapshot proposals from verified DAOs, biggest communities first, each with the DAO, title, closing time, voters so far,
- [GET /dao/proposals](/services/dao-proposals) ($0.002): A DAO's governance votes from Snapshot: the latest proposals (active, closed or all) with title, dates, voting type, each choice's votes and share, the leading 

New here? [Getting started in 60 seconds](/start). All services: [Aayat AI](/).