# Token Dividend Proportional Allocator

> Token Dividend Proportional Allocator is a paid API for AI agents from prop.halowerk.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Calculates each eligible token holder's proportional share of a dividend pool based on their balance, returning allocation amounts without executing any transfer or compliance check.

## Facts

- Endpoint: POST https://prop.halowerk.com/v1/token-dividend
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-dividend-proportional-allocator-87cb4999
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_TYAE3Vz4Cq03FZbmgYZmd

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 token-dividend-proportional-allocator-87cb4999 -d '<json body>'
```

Example prompt: Calculate how much of a 50,000 USDC dividend pool each of my token holders should receive — here's the list of holders with their balances and eligibility flags.

## When to prefer this

Choose this endpoint when you need a pure mathematical dividend allocation computation across up to 100,000 token holders without triggering any on-chain transactions, compliance checks, or wallet lookups. It is ideal for preview/dry-run workflows where you want to verify distribution amounts before execution, or for off-chain record-keeping and audit trails. Not suitable if you need actual token transfers, rounding to token decimal precision, tax withholding, or securities compliance logic.

## Known failure modes

- Empty holders array or all holders ineligible — no eligible balances to sum, division by zero scenario
- total_dividend set to 0 — all allocations return zero
- Holder array exceeds 100,000 items — request rejected
- Negative balance values submitted — violates schema minimum of 0
- Missing required fields (account_id, balance, eligible) on any holder object — validation error

## How this service works

Sums non-negative eligible balances and allocates a caller-supplied pool by balance share. It performs no transfer, wallet lookup, securities analysis, tax withholding, rounding-to-token-decimals or compliance check; output is calculation data only.

## Output

Returns a per-holder breakdown showing each eligible account's allocated dividend amount, calculated as their balance divided by the sum of all eligible balances multiplied by the total dividend. Ineligible holders receive zero allocation. The response is pure calculation data — no transfers are initiated.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "holders": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "account_id",
     "balance",
     "eligible"
    ],
    "properties": {
     "balance": {
      "type": "number",
      "maximum": 1e+30,
      "minimum": 0
     },
     "eligible": {
      "type": "boolean"
     },
     "account_id": {
      "type": "string",
      "maxLength": 256,
      "minLength": 1
     }
    },
    "additionalProperties": false
   },
   "maxItems": 100000,
   "minItems": 1
  },
  "total_dividend": {
   "type": "number",
   "maximum": 1000000000000000,
   "minimum": 0,
   "description": "Amount in a caller-selected currency or token unit."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-dividend-proportional-allocator-87cb4999/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from prop.halowerk.com](https://www.zero.xyz/host/prop.halowerk.com/llms.txt)