# U2A Token Holder Value

> U2A Token Holder Value is a paid API for AI agents from www.u2a.com.au, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-10).

Calculates deterministic token holder-value metrics including real yield, emissions dilution, unlock stress scenarios, and valuation multiples (P/fees, FDV) over a specified period.

## Facts

- Endpoint: POST https://www.u2a.com.au/api/mcp/token-holder-value?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/u2a-token-holder-value-94cc1b37
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_z9pBh-PaOqpvN5xZJ5qZV

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability u2a-token-holder-value-94cc1b37 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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 holder
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/u2a-token-holder-value-94cc1b37/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.u2a.com.au](https://www.zero.xyz/host/www.u2a.com.au/llms.txt)