# Halowerk Voter Turnout Predictor

> Halowerk Voter Turnout Predictor 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).

Applies a fixed logistic equation to caller-supplied governance features and returns an estimated voter turnout range for a proposal or election scenario.

## Facts

- Endpoint: POST https://gov.halowerk.com/v1/voter-turnout-predict
- 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/halowerk-voter-turnout-predictor-1c2ceb1f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Kkxh9hI-ho0-DTR8Mzv0I

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 halowerk-voter-turnout-predictor-1c2ceb1f -d '<json body>'
```

Example prompt: Estimate the likely voter turnout range for our upcoming DAO governance vote: we have 12000 eligible voters, prior turnout was 38%, the voting window is 7 days, we plan to send 2 reminders per voter, there's 1 active proposal, and participation has been trending down by 5 percentage points recently.

## When to prefer this

Choose this endpoint when you need a fast, deterministic, rule-based turnout estimate for governance or DAO voting scenario planning and you already have structured aggregate features (eligible voters, prior turnout, reminders, window length, trend). Prefer it over nothing when no historical ML model exists. Do not use it as a calibrated probabilistic forecast, an individual voter propensity scorer, or a basis for voter targeting — its own documentation explicitly disclaims those use cases.

## Known failure modes

- Missing required fields (proposal_count, eligible_voters) return a 400 validation error
- Values outside allowed bounds (e.g. prior_turnout_rate > 1, eligible_voters < 1) trigger schema validation failures
- Extremely short voting windows (near 0.01 days) may produce degenerate or near-zero estimates
- The fixed logistic equation does not adapt to novel or out-of-distribution governance contexts, potentially producing unreliable ranges
- Payment failure via x402 protocol results in 402 response with no computation performed

## How this service works

Applies a fixed, published logistic equation to aggregate caller-supplied features and reports an estimated turnout range. It is an untrained scenario heuristic, not a calibrated election forecast, individual propensity score, or basis for voter targeting.

## Output

Returns an estimated voter turnout range (e.g. low and high percentage or absolute count bounds) computed by applying a fixed logistic equation to the supplied features. The output is a scenario heuristic intended for planning purposes, not a calibrated statistical forecast or individual propensity score.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "proposal_count": {
   "type": "integer",
   "maximum": 10000,
   "minimum": 1
  },
  "eligible_voters": {
   "type": "integer",
   "maximum": 1000000000,
   "minimum": 1
  },
  "prior_turnout_rate": {
   "type": "number",
   "maximum": 1,
   "minimum": 0
  },
  "voting_window_days": {
   "type": "number",
   "maximum": 365,
   "minimum": 0.01
  },
  "reminders_per_voter": {
   "type": "number",
   "maximum": 100,
   "minimum": 0
  },
  "participation_trend_percentage_points": {
   "type": "number",
   "maximum": 100,
   "minimum": -100
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-voter-turnout-predictor-1c2ceb1f/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)