Api Endpoint

U2A

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.

Open interactive test console

Offering

Provider
www.u2a.com.au
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Blockchain And Crypto
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://www.u2a.com.au/api/mcp/token-holder-value
MIME type
Not provided
First seen
2026-10-16T01:50:32.458Z
Last seen
Tags
Crypto, token-holder-value, real-yield, token-unlocks, tokenomics

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.02 USDC
Atomic price: 20000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "20000",
    "payTo": "0x886e7a8d46E239A9d54F48da163B04bb002B14a0"
  }
]

Observed health

Status
Healthy
Latest latency
94 ms
Average latency
372 ms
HTTP status
200
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "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 schema

{
  "properties": {
    "example": {
      "type": "object"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}