{"uid":"cap_VCpyDq8OqiQDgsoeVil3r","slug":"delegate-alignment-scorer-56245b5b","name":"Delegate Alignment Scorer","description":"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.","url":"https://gov.halowerk.com/v1/delegate-alignment","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KsCWwgzyoOfFg1oAfLIBB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Pre-delegation alignment check","prompt":"Before I delegate my tokens, can you score how closely delegate 0xDEF's past votes match mine? They voted for on prop-101, against on prop-202, and abstain on prop-303; I voted for on prop-101, abstain on prop-202, and against on prop-303. Show me the cosine similarity and exact agreement."},{"title":"DAO governance analytics dashboard","prompt":"I'm building a delegate leaderboard — for each delegate in my list, compute their alignment score against our reference governance committee's votes. Start with delegate A who voted for on GIP-5 (weight 500), against on GIP-7 (weight 1200), and the committee voted for on GIP-5, for on GIP-7."},{"title":"Multi-delegate comparison for voter","prompt":"I want to pick the most aligned delegate from two candidates. Candidate 1 voted for on prop-10, against on prop-11, abstain on prop-12. Candidate 2 voted abstain on prop-10, against on prop-11, for on prop-12. My reference votes are: for on prop-10, against on prop-11, for on prop-12. Give me cosine similarity for each."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:32:57.877Z","isFirstParty":false}