# Halowerk Royalty Split Calculator

> Halowerk Royalty Split Calculator is a paid API for AI agents from creator.halowerk.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Splits a total monetary amount (in minor currency units) among named recipients according to basis-point shares, using floor-and-remainder distribution to ensure exact allocation with no rounding loss.

## Facts

- Endpoint: POST https://creator.halowerk.com/v1/royalty-split
- 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/halowerk-royalty-split-calculator-8351b053
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GHOP_2k6KA4E6iAKImXue

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-royalty-split-calculator-8351b053 -d '<json body>'
```

Example prompt: Split $12,500.00 (1250000 cents, USD) among three co-writers: Alice gets 5000 basis points, Bob gets 3000, and Carol gets 2000 — use floor-and-remainder rounding so the cents add up exactly.

## When to prefer this

Use this endpoint when you need mathematically exact, auditable distribution of a fixed total among named recipients with defined percentage shares — especially in royalty, licensing, or revenue-sharing contexts where every minor unit must be accounted for. Prefer it over custom rounding logic when you need a stable, deterministic tie-break rule. It does not execute payments, so pair it with a payment processor to actually move funds.

## Known failure modes

- Share basis points do not sum to exactly 10000 — returns validation error
- total_minor_units exceeds 900000000000 — returns bounds error
- Empty recipients array — returns validation error
- Duplicate recipient names may cause unexpected tie-break ordering
- Non-integer or negative share_basis_points — returns schema validation error
- Currency string not matching pattern (non-uppercase, too short/long) — returns validation error

## How this service works

Requires shares totaling exactly 10,000 basis points, floors each proportional minor-unit allocation, and distributes leftover units by descending fractional remainder with a stable name tie-break. It performs arithmetic only and does not transfer funds, interpret contracts, withhold tax or resolve rights ownership.

## Output

Returns each recipient's allocated amount in minor currency units (e.g. cents), computed by flooring the proportional share and distributing any leftover units to recipients with the largest fractional remainders (tie-broken by name). The sum of all allocations is guaranteed to equal the supplied total_minor_units.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "currency": {
   "type": "string",
   "pattern": "^[A-Z0-9_-]+$",
   "maxLength": 12,
   "minLength": 3
  },
  "recipients": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "name",
     "share_basis_points"
    ],
    "properties": {
     "name": {
      "type": "string",
      "maxLength": 128,
      "minLength": 1
     },
     "share_basis_points": {
      "type": "integer",
      "maximum": 10000,
      "minimum": 0
     }
    },
    "additionalProperties": false
   },
   "maxItems": 1000,
   "minItems": 1
  },
  "total_minor_units": {
   "type": "integer",
   "maximum": 900000000000,
   "minimum": 0,
   "description": "Whole minor currency units, for example cents; bounded so basis-point products remain exact JavaScript integers."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-royalty-split-calculator-8351b053/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from creator.halowerk.com](https://www.zero.xyz/host/creator.halowerk.com/llms.txt)