{"uid":"cap_CvR757rYLBnMsflugoAZM","slug":"token-gini-index-calculator-d050e724","name":"Token Gini Index Calculator","description":"Sorts caller-supplied non-negative balances and computes the standard finite-sample Gini coefficient plus top-one and top-ten-percent shares. Results cover only supplied accounts and do not identify common ownership, custodians, vesting, delegation, or off-chain claims.","url":"https://gov.halowerk.com/v1/token-gini-index","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"holders":{"type":"array","items":{"type":"object","required":["holder_id","balance"],"properties":{"balance":{"type":"number","maximum":1e+24,"minimum":0},"holder_id":{"type":"string","maxLength":128,"minLength":1}},"additionalProperties":false},"maxItems":100000,"minItems":1}}},"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_wKB1TGVYy7mPsv9uEF3im","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":"Computes the Gini coefficient and top-1%/top-10% concentration shares for a supplied list of token holder balances","exampleAgentPrompt":"Can you calculate the Gini coefficient and top-1% and top-10% concentration shares for this list of token holders and their balances? I have up to 50,000 holder records with holder IDs and balance amounts.","exampleUseCases":[{"title":"DAO governance token fairness audit","prompt":"I have a CSV of all our DAO token holders with their wallet addresses and balances. Can you compute the Gini coefficient and tell me what share the top 1% and top 10% of holders control? I want to assess how decentralized our governance really is."},{"title":"DeFi protocol token distribution report","prompt":"Before our protocol launch, I need to report on how evenly distributed the pre-sale token allocations are. Here are the holder IDs and balances — can you give me the Gini index and top-10% concentration share?"},{"title":"Airdrop equity analysis","prompt":"We just did an airdrop to 20,000 addresses. Can you compute the Gini coefficient across all recipients' final balances to see how concentrated the distribution ended up, including what percentage the top 1% of recipients hold?"}],"resultDescription":"Returns a Gini coefficient (0 = perfect equality, 1 = maximum concentration) computed from the sorted supplied balances, plus the share of total balance held by the top 1% and top 10% of holders. Results are scoped strictly to the supplied accounts and do not reflect common ownership, custodians, vesting schedules, delegation, or off-chain claims.","failureModes":["Empty or missing holders array returns a validation error","Balances with negative values are rejected (minimum is 0)","Array exceeding 100,000 items is rejected","holder_id strings exceeding 128 characters fail validation","Balances exceeding 1e+24 are rejected","Single-element arrays may produce degenerate Gini of 0 with no meaningful concentration signal"],"whenToPreferThis":"Choose this endpoint when you need a standard, reproducible finite-sample Gini coefficient plus top-tier concentration shares computed server-side from raw balance data, especially when handling up to 100,000 holders in a single call. It is purpose-built for token distribution analysis in DAO/DeFi contexts and is more appropriate than general statistics APIs when you need both the Gini index and percentage-share metrics together in one call. Not suitable when you need to account for vesting, delegation, custodial grouping, or off-chain positions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:41:54.352Z","isFirstParty":false}