{
  "x402Version": 2,
  "id": 34860,
  "slug": "34860",
  "resource": "https://www.u2a.com.au/api/mcp/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.",
  "type": "http",
  "serviceName": "U2A",
  "iconUrl": "https://res.cloudinary.com/bdb-prod/image/upload/c_fill,ar_1:1,w_256,h_256,f_auto,q_auto/v1791595390/bazaar-icons/45f23a4ab50e602c.png",
  "resourceType": "MCP Tool",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0x886e7a8d46E239A9d54F48da163B04bb002B14a0",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "20000",
      "amountUsd": 0.02,
      "maxTimeoutSeconds": 600
    }
  ],
  "outputSchema": {
    "properties": {
      "example": {
        "type": "object"
      },
      "type": {
        "type": "string"
      }
    },
    "required": [
      "type"
    ],
    "type": "object"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "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": {
          "example": {
            "jsonrpc": "2.0",
            "result": {
              "provenance": {
                "attests": "calculation",
                "result_hash": "0x…"
              },
              "revenue": {
                "annual_holder_revenue": 14600000,
                "holder_revenue_basis": "breakdown",
                "holder_revenue_yield": 0.0584,
                "status_by_output": {
                  "holder_revenue_yield": {
                    "data_status": "derived",
                    "data_status_reason": "Weakest: revenue.distributions (derived)"
                  }
                }
              },
              "token": {
                "fully_diluted_value": 331250000,
                "market_cap": 250000000,
                "status_by_output": {
                  "market_cap": {
                    "data_status": "verified",
                    "data_status_reason": "All 2 inputs \"verified\"."
                  }
                }
              },
              "unlocks": {
                "count": 2,
                "next_unlock_date": "2026-11-01",
                "share_of_circulating": 0.07,
                "status_by_output": {
                  "total_tokens": {
                    "data_status": "estimated",
                    "data_status_reason": "Weakest: unlock on 2026-12-15 (estimated)"
                  }
                },
                "total_tokens": 700000
              },
              "yields": {
                "annualized_dilution_stress_incl_unlocks": -0.34715556,
                "net_real_yield": -0.06326667,
                "status_by_output": {
                  "net_real_yield": {
                    "data_status": "estimated",
                    "data_status_reason": "Weakest: emissions.tokens (estimated)"
                  }
                }
              }
            }
          },
          "type": "json"
        }
      },
      "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"
      }
    },
    "u2a": {
      "category": "Data",
      "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.",
      "tags": [
        "crypto",
        "token-holder-value",
        "real-yield",
        "token-unlocks",
        "tokenomics"
      ]
    }
  },
  "tags": [
    "crypto",
    "token-holder-value",
    "real-yield",
    "token-unlocks",
    "tokenomics",
    "bazaar",
    "u2a"
  ],
  "sourceHost": "www.u2a.com.au",
  "lastUpdated": "2026-10-12T23:32:44.777Z",
  "quality": {
    "calls30d": 5,
    "uniquePayers30d": 2,
    "lastCalledAt": "2026-10-12T23:32:44.589Z"
  },
  "metadata": {
    "serviceName": "U2A",
    "iconUrl": "https://res.cloudinary.com/bdb-prod/image/upload/c_fill,ar_1:1,w_256,h_256,f_auto,q_auto/v1791595390/bazaar-icons/45f23a4ab50e602c.png",
    "extensions": {
      "bazaar": {
        "info": {
          "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": {
            "example": {
              "jsonrpc": "2.0",
              "result": {
                "provenance": {
                  "attests": "calculation",
                  "result_hash": "0x…"
                },
                "revenue": {
                  "annual_holder_revenue": 14600000,
                  "holder_revenue_basis": "breakdown",
                  "holder_revenue_yield": 0.0584,
                  "status_by_output": {
                    "holder_revenue_yield": {
                      "data_status": "derived",
                      "data_status_reason": "Weakest: revenue.distributions (derived)"
                    }
                  }
                },
                "token": {
                  "fully_diluted_value": 331250000,
                  "market_cap": 250000000,
                  "status_by_output": {
                    "market_cap": {
                      "data_status": "verified",
                      "data_status_reason": "All 2 inputs \"verified\"."
                    }
                  }
                },
                "unlocks": {
                  "count": 2,
                  "next_unlock_date": "2026-11-01",
                  "share_of_circulating": 0.07,
                  "status_by_output": {
                    "total_tokens": {
                      "data_status": "estimated",
                      "data_status_reason": "Weakest: unlock on 2026-12-15 (estimated)"
                    }
                  },
                  "total_tokens": 700000
                },
                "yields": {
                  "annualized_dilution_stress_incl_unlocks": -0.34715556,
                  "net_real_yield": -0.06326667,
                  "status_by_output": {
                    "net_real_yield": {
                      "data_status": "estimated",
                      "data_status_reason": "Weakest: emissions.tokens (estimated)"
                    }
                  }
                }
              }
            },
            "type": "json"
          }
        },
        "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"
        }
      },
      "u2a": {
        "category": "Data",
        "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.",
        "tags": [
          "crypto",
          "token-holder-value",
          "real-yield",
          "token-unlocks",
          "tokenomics"
        ]
      }
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": false,
  "featured": false,
  "provider": {
    "host": "www.u2a.com.au",
    "manifest_name": "www.u2a.com.au",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-10-14T01:15:01.050Z"
  },
  "exampleResponse": {
    "example": {},
    "type": "string"
  }
}