Votes API

[
  {
    "transactionHash": "0xabc...123",
    "address": "0x1234567890abcdef1234567890abcdef12345678",
    "proposalId": "123",
    "support": 1,
    "weight": "50000000000000000000000",
    "reason": "This proposal improves the protocol.",
    "blockNumber": "18525000",
    "params": null,
    "proposalTitle": "Upgrade Treasury Timelock",
    "proposalType": "STANDARD"
  }
]

{
  addressOrENSName: string;
  pagination?: {
    limit: number;    // Default: 20
    offset: number;   // Default: 0
  };
}

{
  "meta": {
    "has_next": true,
    "next_offset": 20,
    "total_returned": 20,
    "total_count": 87
  },
  "data": [
    {
      "transactionHash": "0xabc...123",
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "proposalId": "123",
      "support": 1,
      "weight": "50000000000000000000000",
      "reason": "Strong support for this upgrade.",
      "blockNumber": "18525000",
      "proposalTitle": "Upgrade Treasury Timelock",
      "proposalType": "STANDARD",
      "timestamp": "2024-01-15T14:23:45Z"
    }
  ]
}

{
  proposalId: string;
  pagination?: {
    limit: number;    // Default: 20, Max: varies by endpoint
    offset: number;   // Default: 0
  };
  sort?: "weight" | "block_number";  // Default: "weight"
  offchainProposalId?: string;        // For offchain proposals
}

{
  "meta": {
    "has_next": true,
    "next_offset": 20,
    "total_returned": 20,
    "total_count": 156
  },
  "data": [
    {
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "support": 1,
      "weight": "50000000000000000000000",
      "reason": "Strongly in favor of this proposal.",
      "transactionHash": "0xabc...123",
      "blockNumber": "18525000",
      "proposalId": "123",
      "proposalTitle": "Upgrade Treasury Timelock",
      "proposalType": "STANDARD"
    }
  ]
}

{
  proposalId: string;
  pagination?: {
    limit: number;    // Default: 20
    offset: number;   // Default: 0
  };
  offchainProposalId?: string;
  type?: "TH" | "APP" | "CHAIN" | "USER";  // Voter type
}

{
  "meta": {
    "has_next": true,
    "next_offset": 20,
    "total_returned": 20,
    "total_count": 1234
  },
  "data": [
    {
      "delegate": "0x1234567890abcdef1234567890abcdef12345678",
      "voting_power": "5000000000000000000000",
      "citizen_type": "app",
      "voterMetadata": {
        "name": "Protocol Name",
        "image": "https://...",
        "type": "application"
      },
      "twitter": "@handle",
      "discord": "user#1234",
      "warpcast": null
    }
  ]
}

{
  addressOrENSName: string;
  pagination?: PaginationParams;
}

{
  proposalId: string;
  pagination?: PaginationParams;
  sort?: string;  // Default: "vp" (voting power)
}

{
  "id": "0xsnapshotid",
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "createdAt": "2024-01-15T14:23:45Z",
  "choice": "Option 1",
  "votingPower": 5000,
  "title": "Proposal Title",
  "reason": "I support this because...",
  "choiceLabels": {
    "1": "Option 1",
    "2": "Option 2"
  }
}

-- Vote aggregation query
SELECT
  STRING_AGG(transaction_hash,'|') as transaction_hash,
  proposal_id,
  voter,
  support,
  SUM(weight) as weight,
  STRING_AGG(distinct reason, '\n --------- \n') as reason,
  MAX(block_number) as block_number,
  params
FROM (
  SELECT * FROM vote_cast_events WHERE proposal_id = $1
  UNION ALL
  SELECT * FROM vote_cast_with_params_events WHERE proposal_id = $1
  UNION ALL
  SELECT * FROM citizen_votes WHERE proposal_id = $1
) t
GROUP BY proposal_id, voter, support, params
ORDER BY weight DESC

async function getVotesCountForDelegateForAddress({
  address: string;
}): Promise<number> {
  // Returns count of distinct proposals voted on
}

87

async function getVoterStats(
  addressOrENSName: string,
  blockNumberOrTimestamp?: number
): Promise<VoterStats> {
  // Returns participation statistics
}

{
  "voter": "0x1234567890abcdef1234567890abcdef12345678",
  "last_10_props": "8",
  "total_proposals": "100"
}

{
  "support": 2,        // Voting for option 2
  "params": "[2]",     // Option index in params
  "proposalType": "APPROVAL"
}

{
  "support": 1,
  "params": "[1,3,2]",  // Ranked preferences
  "proposalType": "RANKED_CHOICE"
}

{
  "support": 0,          // 0 = veto
  "proposalType": "OPTIMISTIC"
}

GET /api/v1/proposals/123/votes?sort=weight

GET /api/v1/proposals/123/votes?sort=block_number

GET /api/v1/proposals/123/votes?limit=50&offset=100

const response = await fetch(
  'https://vote.ens.domains/api/common/votes/delegate/0x1234...5678?limit=100',
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);

const response = await fetch(
  'https://vote.ens.domains/api/v1/proposals/123/votes?sort=weight&limit=1000',
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);

const response = await fetch(
  'https://vote.ens.domains/api/v1/proposals/123/non-voters?limit=100',
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);

const response = await fetch(
  'https://vote.ens.domains/api/v1/delegates/0x1234...5678/stats',
  { headers: { 'Authorization': 'Bearer YOUR_API_KEY' } }
);

{
  "error": "Missing address, blockNumber, or proposalId",
  "status": 400
}

{
  "error": "Invalid address format",
  "status": 400
}

{
  "error": "Proposal not found",
  "status": 404
}