# Delegate Alignment Scorer

> Delegate Alignment Scorer is a paid API for AI agents from gov.halowerk.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Computes weighted cosine similarity and exact agreement rate between two vote vectors (delegate and reference) joined by proposal ID, encoding against/abstain/for as -1/0/1.

## Facts

- Endpoint: POST https://gov.halowerk.com/v1/delegate-alignment
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/delegate-alignment-scorer-56245b5b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VCpyDq8OqiQDgsoeVil3r

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability delegate-alignment-scorer-56245b5b -d '<json body>'
```

Example prompt: Compare how aligned delegate 0xABC is with my own voting record — here are their votes on proposals P1 (for=1), P2 (against=-1), P3 (abstain=0) and my votes on the same proposals P1 (for=1), P2 (for=1), P3 (against=-1); give me the weighted cosine similarity and exact agreement rate.

## When to prefer this

Use this endpoint when you need a mathematically precise, reproducible alignment score between two specific sets of governance votes joined by proposal ID, with optional weighting. Prefer it over manual comparison when vote sets are large, when weights differ by proposal, or when you need both cosine similarity and exact agreement simultaneously. It is strictly a computation — it does not access chain data, so you must supply both vote arrays yourself.

## Known failure modes

- No overlapping proposal IDs between delegate_votes and reference_votes — returns zero or undefined similarity
- Vote values outside the allowed enum (-1, 0, 1) cause validation errors
- Arrays exceeding 10,000 items are rejected
- Weight values outside [0.000001, 1,000,000,000,000] are rejected
- Missing required fields (proposal_id or vote) in any item cause schema validation failure
- Payment failure or insufficient USDC balance returns 402

## How this service works

Joins caller-supplied vote vectors by proposal ID, encodes against/abstain/for as -1/0/1, and computes weighted cosine similarity plus exact agreement. It describes only supplied overlapping votes and does not infer ideology or future behavior.

## Output

Returns a weighted cosine similarity score (ranging -1 to 1) and an exact agreement rate (0 to 1) computed over the overlapping proposal IDs between the delegate and reference vote arrays. The response describes only the supplied overlapping votes and does not infer ideology or predict future behavior.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "delegate_votes": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "proposal_id",
     "vote"
    ],
    "properties": {
     "vote": {
      "enum": [
       -1,
       0,
       1
      ],
      "type": "integer"
     },
     "weight": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": 0.000001
     },
     "proposal_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 1
     }
    },
    "additionalProperties": false
   },
   "maxItems": 10000,
   "minItems": 1
  },
  "reference_votes": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "proposal_id",
     "vote"
    ],
    "properties": {
     "vote": {
      "enum": [
       -1,
       0,
       1
      ],
      "type": "integer"
     },
     "proposal_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 1
     }
    },
    "additionalProperties": false
   },
   "maxItems": 10000,
   "minItems": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/delegate-alignment-scorer-56245b5b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gov.halowerk.com](https://www.zero.xyz/host/gov.halowerk.com/llms.txt)