{"slug":"www-u2a-com-au-api-mcp-token-holder-value-b111d6","title":"Token holder-value check","host":"www.u2a.com.au","method":"POST","resource":"https://www.u2a.com.au/api/mcp/token-holder-value","category":"market","description":"Token holder-value check: holder revenue yield vs emissions dilution, net real yield, and an annualized unlock-dilution stress scenario over the next 90 days. Also P/holder-revenue, P/fees, FDV and unlock schedules. Deterministic; caller-asserted data status with reason for every top-level calculate","price_listed":0.02,"price_asked":0.02,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":261,"reported_calls_30d":2,"reported_payers_30d":2,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"as_of":"2026-10-09","emissions":{"period_days":30,"tokens":100000},"revenue":{"buyback_burn":300000,"distributions":900000,"fees":3000000,"period_days":30},"token":{"circulating_supply":10000000,"max_supply":13250000,"price":{"source":"coingecko","status":"verified","value":25},"symbol":"GMX"},"unlocks":[{"category":"investors","date":"2026-12-15","source":"blog post","status":"estimated","tokens":500000}]},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"properties":{"as_of":{"description":"Valuation date (YYYY-MM-DD).","format":"date","type":"string"},"currency":{"default":"USD","description":"Currency label; no conversion.","type":"string"},"emissions":{"description":"New tokens issued as incentives or rewards. Optional.","properties":{"includes_scheduled_unlocks":{"default":false,"description":"True if emissions already include the unlocks below (avoids double counting).","type":"boolean"},"period_days":{"description":"Emissions period in days.","maximum":3650,"minimum":1,"type":"number"},"tokens":{"description":"Tokens emitted in the period. Number, or object shaped like token.price.","type":["number","object"]}},"required":["period_days","tokens"],"type":"object"},"horizon_days":{"default":90,"description":"Unlock window in days. Default 90.","maximum":365,"minimum":1,"type":"number"},"revenue":{"description":"Revenue over a recent period, annualised linearly.","properties":{"buyback_burn":{"description":"Bought back and burned, in currency. Counted. Number, or object shaped like token.price.","type":["number","object"]},"buyback_treasury":{"description":"Bought back and held by treasury. Excluded unless include_treasury_buybacks. Number, or object shaped like token.price.","type":["number","object"]},"distributions":{"description":"Paid out to holders/stakers. Counted. Number, or object shaped like token.price.","type":["number","object"]},"fees":{"description":"Fees paid by users. Optional. Number, or object shaped like token.price.","type":["number","object"]},"holder_revenue":{"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.","type":["number","object"]},"include_treasury_buybacks":{"default":false,"description":"Count treasury buybacks as holder revenue.","type":"boolean"},"period_days":{"description":"Revenue period in days, e.g. 30.","maximum":3650,"minimum":1,"type":"number"},"protocol_revenue":{"description":"Protocol revenue (holders + treasury). Optional. Number, or object shaped like token.price.","type":["number","object"]}},"required":["period_days"],"type":"object"},"token":{"description":"The token being analysed.","properties":{"circulating_supply":{"description":"Tokens currently circulating. Number, or object shaped like token.price.","type":["number","object"]},"max_supply":{"description":"Max supply, for FDV. Optional. Number, or object shaped like token.price.","type":["number","object"]},"price":{"description":"Token price in the chosen currency. A number, or {value, status, source, observed_at}.","oneOf":[{"minimum":0,"type":"number"},{"properties":{"observed_at":{"description":"When observed (ISO).","format":"date-time","type":"string"},"source":{"description":"Where it came from.","maxLength":500,"type":"string"},"status":{"description":"How it was obtained. Default \"provided\".","enum":["verified","derived","provided","estimated","assumed"],"type":"string"},"value":{"description":"The number.","minimum":0,"type":"number"}},"required":["value"],"type":"object"}]},"symbol":{"description":"Token symbol, e.g. GMX.","type":"string"}},"required":["symbol","price","circulating_supply"],"type":"object"},"unlocks":{"description":"Vesting unlocks; only those inside the window count.","items":{"properties":{"category":{"description":"e.g. team, investors.","type":"string"},"date":{"description":"Unlock date.","format":"date","type":"string"},"source":{"description":"Schedule source.","type":"string"},"status":{"description":"Reliability. Default \"provided\".","enum":["verified","derived","provided","estimated","assumed"],"type":"string"},"tokens":{"description":"Tokens unlocking.","minimum":0,"type":"number"}},"required":["date","tokens"],"type":"object"},"maxItems":1000,"type":"array"}},"required":["as_of","token","revenue"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-10","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.02,"price_match":true,"latency_ms":261,"error":null}],"description_full":"Token holder-value check: holder revenue yield vs emissions dilution, net real yield, and an annualized unlock-dilution stress scenario over the next 90 days. Also P/holder-revenue, P/fees, FDV and unlock schedules. Deterministic; caller-asserted data status with reason for every top-level calculated figure; hashed and optionally signed. No LLM.","last_updated":"2026-10-10T01:29:13.969Z","schemes":["exact"]}