{"id":"allocate","title":"Split a money amount into parts that sum exactly to the total","description":"Splits one signed amount into up to 500 parts by weights (or equal parts), in integer minor units of its currency, for an agent dividing a bill, a refund, a fee or a tax. Each share is rounded under the declared mode, then the leftover minor units are assigned by the declared remainder policy, so the parts always sum to the total exactly. Negative totals (refunds) are supported; zero-weight parts get zero. Fails when the total has more fraction digits than the currency, or the weights sum to zero. Does not choose a policy for you and does not apply cash rounding or tax.","roi":"A 3-way split of $100.00 that returns 33.33 x 3 loses a cent. Exact to the minor unit, for every rounding mode.","audience":"business","package":"money-math-kit","channels":["x402","mcp"],"endpoint":{"method":"POST","url":"https://agents.writerslogic.com/api/v1/allocate","path":"/api/v1/allocate","contentType":"application/json"},"price":{"amount":"0.005","currency":"USDC","network":"base","perCall":true,"failedCallsCharged":false},"inputSchema":{"type":"object","additionalProperties":false,"required":["total"],"properties":{"total":{"type":"string","pattern":"^-?\\d{1,15}(\\.\\d{1,12})?$","maxLength":30,"description":"Decimal string such as \"-12.50\" (up to 15 integer and 12 fraction digits). JSON numbers are not accepted: they are binary floats."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"ISO 4217 alphabetic code, upper case."},"exponent":{"type":"integer","minimum":0,"maximum":8,"description":"Override the ISO 4217 exponent; required for codes not on the list."},"weights":{"type":"array","minItems":1,"maxItems":500,"items":{"type":"string","pattern":"^\\d{1,15}(\\.\\d{1,12})?$","maxLength":28},"description":"Non-negative decimal-string weights, e.g. [\"1\",\"1\",\"2\"] or percentages. Give weights or parts."},"parts":{"type":"integer","minimum":1,"maximum":500,"description":"Equal split into this many parts."},"rounding":{"type":"string","enum":["half-up","half-down","half-even","up","down","ceiling","floor"],"description":"Rounding of each share before the residual is moved. Default half-even. half-up: ties away from zero. half-down: ties toward zero. half-even: ties to the even neighbour. up: away from zero. down: toward zero. ceiling: toward +infinity. floor: toward -infinity."},"remainder":{"type":"string","enum":["largest-remainder","first","last"],"description":"largest-remainder (default): one unit at a time to the part with the largest rounding claim, ties to the lowest index. first / last: the whole residual to the first / last part with positive weight."}}},"resultSchema":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"allocations":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"weight":{"type":"string"},"minor":{"type":"integer"},"amount":{"type":"string"}}}},"totalMinor":{"type":"integer"},"sumMinor":{"type":"integer","description":"Sum of the parts; equals totalMinor."},"residualMinor":{"type":"integer","description":"Minor units moved after per-share rounding (signed)."},"exponent":{"type":"integer"},"rounding":{"type":"string"},"remainder":{"type":"string"},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"outputSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"allocations":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"weight":{"type":"string"},"minor":{"type":"integer"},"amount":{"type":"string"}}}},"totalMinor":{"type":"integer"},"sumMinor":{"type":"integer","description":"Sum of the parts; equals totalMinor."},"residualMinor":{"type":"integer","description":"Minor units moved after per-share rounding (signed)."},"exponent":{"type":"integer"},"rounding":{"type":"string"},"remainder":{"type":"string"},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]},"example":{"total":"100.00","currency":"USD","weights":["1","1","1"]},"openapiOperation":{"operationId":"allocate","summary":"Split a money amount into parts that sum exactly to the total","description":"Splits one signed amount into up to 500 parts by weights (or equal parts), in integer minor units of its currency, for an agent dividing a bill, a refund, a fee or a tax. Each share is rounded under the declared mode, then the leftover minor units are assigned by the declared remainder policy, so the parts always sum to the total exactly. Negative totals (refunds) are supported; zero-weight parts get zero. Fails when the total has more fraction digits than the currency, or the weights sum to zero. Does not choose a policy for you and does not apply cash rounding or tax.\n\nPrice: 0.005 USDC on Base (x402).","x-x402-price-usdc":"0.005","x-x402-amount":"5000","x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.005"}},"x-audience":"business","x-sample-url":"https://agents.writerslogic.com/api/v1/samples/allocate","security":[{"x402":[]},{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["total"],"properties":{"total":{"type":"string","pattern":"^-?\\d{1,15}(\\.\\d{1,12})?$","maxLength":30,"description":"Decimal string such as \"-12.50\" (up to 15 integer and 12 fraction digits). JSON numbers are not accepted: they are binary floats."},"currency":{"type":"string","pattern":"^[A-Z]{3}$","description":"ISO 4217 alphabetic code, upper case."},"exponent":{"type":"integer","minimum":0,"maximum":8,"description":"Override the ISO 4217 exponent; required for codes not on the list."},"weights":{"type":"array","minItems":1,"maxItems":500,"items":{"type":"string","pattern":"^\\d{1,15}(\\.\\d{1,12})?$","maxLength":28},"description":"Non-negative decimal-string weights, e.g. [\"1\",\"1\",\"2\"] or percentages. Give weights or parts."},"parts":{"type":"integer","minimum":1,"maximum":500,"description":"Equal split into this many parts."},"rounding":{"type":"string","enum":["half-up","half-down","half-even","up","down","ceiling","floor"],"description":"Rounding of each share before the residual is moved. Default half-even. half-up: ties away from zero. half-down: ties toward zero. half-even: ties to the even neighbour. up: away from zero. down: toward zero. ceiling: toward +infinity. floor: toward -infinity."},"remainder":{"type":"string","enum":["largest-remainder","first","last"],"description":"largest-remainder (default): one unit at a time to the part with the largest rounding claim, ties to the lowest index. first / last: the whole residual to the first / last part with positive weight."}}},"example":{"total":"100.00","currency":"USD","weights":["1","1","1"]}}}},"responses":{"200":{"description":"Paid result with provenance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"status":{"type":"string","enum":["pass","fail","unknown","unsupported"],"description":"pass: every rule held. fail: a rule was violated (see witnesses). unknown: the input lacks the evidence to decide. unsupported: outside what this engine covers. Missing evidence is never a pass."},"allocations":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"weight":{"type":"string"},"minor":{"type":"integer"},"amount":{"type":"string"}}}},"totalMinor":{"type":"integer"},"sumMinor":{"type":"integer","description":"Sum of the parts; equals totalMinor."},"residualMinor":{"type":"integer","description":"Minor units moved after per-share rounding (signed)."},"exponent":{"type":"integer"},"rounding":{"type":"string"},"remainder":{"type":"string"},"witnesses":{"type":"array","items":{"type":"object","properties":{"ruleId":{"type":"string"},"detail":{"type":"string"},"path":{"type":"string","description":"JSON pointer or dotted path into the input."},"offset":{"type":"integer"},"index":{"type":"integer"},"expected":{"description":"What the rule required."},"actual":{"description":"What the input had."}}}},"versions":{"type":"object","description":"Every semantic dependency of this answer (engine, tables and their as-of dates, tokenizer, calendar, rounding profile)."},"limits":{"type":"array","items":{"type":"string"}},"deterministic":{"type":"boolean","description":"Always true: pure code, no model."}}},"_provenance":{"type":"object","description":"C2PA-aligned manifest and W3C VC 2.0 (eddsa-jcs-2022) issued by the hub DID; verify at POST /api/v1/verify-provenance"}},"required":["data","_provenance"]}}}},"400":{"description":"Invalid request (no payment consumed)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"401":{"description":"Invalid X-API-KEY","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}},"402":{"description":"Payment required or invalid","content":{"application/json":{"schema":{"type":"object","description":"x402 v2 PaymentRequired (also base64 in the PAYMENT-REQUIRED header)","properties":{"x402Version":{"type":"integer"},"error":{"type":"string"},"code":{"type":"string"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}},"502":{"description":"Upstream failure; the payment is released or not settled","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"}}}}}}}},"links":{"docs":"https://agents.writerslogic.com/docs/allocate/","docsJson":"https://agents.writerslogic.com/docs/allocate.json","sample":"https://agents.writerslogic.com/api/v1/samples/allocate","openapi":"https://agents.writerslogic.com/openapi.json","catalog":"https://agents.writerslogic.com/api/v1/catalog","verifyProvenance":"https://agents.writerslogic.com/api/v1/verify-provenance","index":"https://agents.writerslogic.com/docs/index.json"}}