{"uid":"cap_z9pBh-PaOqpvN5xZJ5qZV","slug":"u2a-token-holder-value-94cc1b37","name":"U2A Token Holder Value","description":"Real-yield and token-unlock dilution check for any crypto token: holder revenue yield vs emissions dilution, net real yield, and a 90-day unlock stress test. Also FDV, P/fees and P/holder-revenue. You supply price, supply, revenue, emissions and unlock data (e.g. from CoinGecko, DefiLlama or TokenUnlocks); returns deterministic, reproducible figures (no LLM), with a data-status reason for every top-level calculated figure, hashed and optionally signed.","url":"https://www.u2a.com.au/api/mcp/token-holder-value?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"as_of":{"type":"string","format":"date","description":"Valuation date (YYYY-MM-DD)."},"token":{"type":"object","required":["symbol","price","circulating_supply"],"properties":{"price":{"oneOf":[{"type":"number","minimum":0},{"type":"object","required":["value"],"properties":{"value":{"type":"number","minimum":0,"description":"The number."},"source":{"type":"string","maxLength":500,"description":"Where it came from."},"status":{"enum":["verified","derived","provided","estimated","assumed"],"type":"string","description":"How it was obtained. Default \"provided\"."},"observed_at":{"type":"string","format":"date-time","description":"When observed (ISO)."}}}],"description":"Token price in the chosen currency. A number, or {value, status, source, observed_at}."},"symbol":{"type":"string","description":"Token symbol, e.g. GMX."},"max_supply":{"type":["number","object"],"description":"Max supply, for FDV. Optional. Number, or object shaped like token.price."},"circulating_supply":{"type":["number","object"],"description":"Tokens currently circulating. Number, or object shaped like token.price."}},"description":"The token being analysed."},"revenue":{"type":"object","required":["period_days"],"properties":{"fees":{"type":["number","object"],"description":"Fees paid by users. Optional. Number, or object shaped like token.price."},"period_days":{"type":"number","maximum":3650,"minimum":1,"description":"Revenue period in days, e.g. 30."},"buyback_burn":{"type":["number","object"],"description":"Bought back and burned, in currency. Counted. Number, or object shaped like token.price."},"distributions":{"type":["number","object"],"description":"Paid out to holders/stakers. Counted. Number, or object shaped like token.price."},"holder_revenue":{"type":["number","object"],"description":"Total value to holders in the period. Overridden by the breakdown when distributions or buyback_burn is given (or buyback_treasury with include_treasury_buybacks). Number, or object shaped like token.price."},"buyback_treasury":{"type":["number","object"],"description":"Bought back and held by treasury. Excluded unless include_treasury_buybacks. Number, or object shaped like token.price."},"protocol_revenue":{"type":["number","object"],"description":"Protocol revenue (holders + treasury). Optional. Number, or object shaped like token.price."},"include_treasury_buybacks":{"type":"boolean","default":false,"description":"Count treasury buybacks as holder revenue."}},"description":"Revenue over a recent period, annualised linearly."},"unlocks":{"type":"array","items":{"type":"object","required":["date","tokens"],"properties":{"date":{"type":"string","format":"date","description":"Unlock date."},"source":{"type":"string","description":"Schedule source."},"status":{"enum":["verified","derived","provided","estimated","assumed"],"type":"string","description":"Reliability. Default \"provided\"."},"tokens":{"type":"number","minimum":0,"description":"Tokens unlocking."},"category":{"type":"string","description":"e.g. team, investors."}}},"maxItems":1000,"description":"Vesting unlocks; only those inside the window count."},"currency":{"type":"string","default":"USD","description":"Currency label; no conversion."},"emissions":{"type":"object","required":["period_days","tokens"],"properties":{"tokens":{"type":["number","object"],"description":"Tokens emitted in the period. Number, or object shaped like token.price."},"period_days":{"type":"number","maximum":3650,"minimum":1,"description":"Emissions period in days."},"includes_scheduled_unlocks":{"type":"boolean","default":false,"description":"True if emissions already include the unlocks below (avoids double counting)."}},"description":"New tokens issued as incentives or rewards. Optional."},"horizon_days":{"type":"number","default":90,"maximum":365,"minimum":1,"description":"Unlock window in days. Default 90."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_r6ZtpgwEJLa9yPhhJ-lf7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates deterministic token holder-value metrics including real yield, emissions dilution, unlock stress scenarios, and valuation multiples (P/fees, FDV) over a specified period.","exampleAgentPrompt":"Run a token holder value check on GMX as of 2024-06-01 — it's priced at $28.50 with 9.5 million tokens circulating, $4.2M in holder distributions and $1.1M in buyback/burn over the last 30 days, and a max supply of 13.25 million. I want the real yield, dilution stress scenario for the next 90 days, and FDV.","exampleUseCases":[{"title":"DeFi staking due diligence","prompt":"Before I stake my ARB tokens, can you calculate the net real yield after emissions dilution? The token is at $1.12, circulating supply is 3.4 billion, max supply 10 billion, and it distributed $8M to stakers over the last 30 days. Run the 90-day unlock stress scenario too."},{"title":"Protocol revenue multiple valuation","prompt":"I need the P/fees and P/holder-revenue multiples for a token I'm researching — symbol is GMXV2, price $24, circulating supply 9.2M, max supply 13.25M, total fees $6.5M and distributions $2.8M over the past 30 days, valued as of 2024-07-15."},{"title":"Unlock dilution impact analysis","prompt":"Can you stress-test the holder value impact of upcoming token unlocks for PENDLE over the next 90 days? Current price is $3.80, circulating supply 130M, max supply 258.4M, and holders received $900K in buyback-burn and $400K in distributions over the last 30 days."}],"resultDescription":"Returns deterministic calculations including: holder revenue yield, emissions dilution rate, net real yield (yield minus dilution), a 90-day annualized unlock-dilution stress scenario, P/holder-revenue and P/fees multiples, and FDV. Every top-level figure includes a data status label (verified/derived/provided/estimated/assumed) and a human-readable reason. The response is hashed and optionally cryptographically signed for auditability. No LLM inference is used — all outputs are deterministic given the inputs.","failureModes":["Missing required fields (symbol, price, circulating_supply) return validation errors","Revenue period_days outside 1–3650 range is rejected","Inconsistent holder_revenue with breakdown fields (distributions + buyback_burn) may cause override warnings","If max_supply is omitted, FDV cannot be calculated and is omitted from output","Stale or unverified input data is flagged in status fields but does not block computation","Payment failure (insufficient USDC balance) results in 402 response before computation"],"whenToPreferThis":"Choose this endpoint when you need deterministic, auditable tokenomics analysis — specifically net real yield after dilution, holder revenue multiples, and forward-looking unlock stress scenarios. Prefer it over generic DeFi data APIs when you need signed/hashed outputs for compliance, transparent data-status provenance on every figure, or reproducible calculations that don't depend on LLM inference. Best suited for token due diligence, staking decisions, and protocol valuation work where accountability of the computation matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T12:30:04.995Z","isFirstParty":false,"canonicalSlug":"u2a-token-holder-value-94cc1b37"}