{"uid":"cap_TYAE3Vz4Cq03FZbmgYZmd","slug":"token-dividend-proportional-allocator-87cb4999","name":"Token Dividend Proportional Allocator","description":"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.","url":"https://prop.halowerk.com/v1/token-dividend","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_O9GA_Z7C_lp-YyDqBLyWw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Quarterly token dividend payout calculation","prompt":"I need to distribute 100,000 USDC as a quarterly dividend across all my token holders. Can you calculate each eligible holder's proportional share based on their current balances? I'll provide the full holder list with balances and which accounts are eligible."},{"title":"Airdrop allocation preview before execution","prompt":"Before I execute an airdrop of 500,000 tokens, calculate how much each eligible wallet should receive proportional to their existing balance. Here are 2,000 holders — some are ineligible and should be excluded from the pool."},{"title":"Profit-share split for a DAO treasury distribution","prompt":"Our DAO wants to distribute 25,000 USDC from the treasury to all eligible members weighted by their governance token balance. Can you compute each member's allocation so we can review the numbers before we send anything?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:39:56.995Z","isFirstParty":false}