{
  "schema_version": "1",
  "portal_version": "1.0.0-foundation",
  "updated_at": "2026-07-20",
  "source": "marco.public_portal",
  "provenance": "marco_metrics_registry",
  "data": {
    "schema_version": "1.0.0",
    "data_version": "2026-07-21",
    "authority": {
      "holder_data_authority": "CONFIGURED_EXTERNAL_PROVIDER_OR_INDEXER",
      "passport_metric_authority": "PASSPORT_CORE",
      "economic_authority": "NONE",
      "settlement_authority": "NONE"
    },
    "freshness_policy": {
      "cache_seconds_default": 300,
      "stale_seconds_default": 3600,
      "notes": "Values older than stale_seconds are downgraded to STALE. Values without a live provider or verified snapshot are UNAVAILABLE."
    },
    "definitions": [
      {
        "metric_id": "ON_CHAIN_HOLDERS",
        "label": "On-chain MARCO holders",
        "definition": "Unique blockchain addresses currently holding a positive MARCO balance according to the configured authoritative data provider.",
        "unit": "addresses",
        "initial_status": "UNAVAILABLE",
        "never_call": [
          "users",
          "humans",
          "Passport members",
          "active customers",
          "verified holders"
        ],
        "notes": "Addresses are not people. A single subject may control multiple wallets and multiple subjects may share custodial infrastructure."
      },
      {
        "metric_id": "PASSPORTS_ISSUED",
        "label": "MARCO Passports issued",
        "definition": "Total persistent MARCO Passports successfully issued by Passport Core.",
        "unit": "passports",
        "initial_status": "LIVE",
        "never_call": []
      },
      {
        "metric_id": "PUBLIC_PASSPORTS",
        "label": "Public Passports",
        "definition": "Total Passports currently in ACTIVE_PUBLIC lifecycle state.",
        "unit": "passports",
        "initial_status": "LIVE",
        "never_call": []
      },
      {
        "metric_id": "PRIVATE_PASSPORTS",
        "label": "Private Passports",
        "definition": "Total Passports currently in ACTIVE_PRIVATE lifecycle state.",
        "unit": "passports",
        "initial_status": "LIVE",
        "never_call": []
      },
      {
        "metric_id": "ACTIVE_PASSPORTS",
        "label": "Active Passports",
        "definition": "Passports demonstrating activity inside a canonical activity window. Not yet defined.",
        "unit": "passports",
        "initial_status": "NOT_DEFINED",
        "never_call": [],
        "notes": "Do not publish until an operational activity window and canonical definition exist."
      },
      {
        "metric_id": "MARCO_MERCHANTS",
        "label": "MARCO merchants",
        "definition": "Verified merchants participating in the MARCO merchant program. The program is not yet live.",
        "unit": "merchants",
        "initial_status": "PLANNED",
        "never_call": [],
        "notes": "Do not present zero as though a live program exists."
      },
      {
        "metric_id": "M_CREDITS_CIRCULATING",
        "label": "M-Credits circulating",
        "definition": "Treasury-authorized M-Credits in circulation. Treasury Runtime is the sole economic authority; no value is exposed here.",
        "unit": "credits",
        "initial_status": "PLANNED",
        "never_call": []
      }
    ],
    "readings": {
      "ON_CHAIN_HOLDERS": {
        "status": "UNAVAILABLE",
        "value": null,
        "unit": "addresses",
        "chain_id": 56,
        "contract_address": "0x963556de0eb8138e97a85f0a86ee0acd159d210b",
        "provider": "bscscan_v2",
        "observed_at": null,
        "provenance": "no_source",
        "warnings": [
          "provider_error:provider_payload_rejected",
          "no_snapshot_available"
        ],
        "deltas": [
          {
            "window": "24h",
            "status": "UNAVAILABLE",
            "absolute_change": null,
            "percentage_change": null,
            "baseline_value": null,
            "current_value": null,
            "baseline_observed_at": null,
            "current_observed_at": null,
            "baseline_age_difference_seconds": null,
            "tolerance_window_seconds": 21600
          },
          {
            "window": "7d",
            "status": "UNAVAILABLE",
            "absolute_change": null,
            "percentage_change": null,
            "baseline_value": null,
            "current_value": null,
            "baseline_observed_at": null,
            "current_observed_at": null,
            "baseline_age_difference_seconds": null,
            "tolerance_window_seconds": 129600
          },
          {
            "window": "30d",
            "status": "UNAVAILABLE",
            "absolute_change": null,
            "percentage_change": null,
            "baseline_value": null,
            "current_value": null,
            "baseline_observed_at": null,
            "current_observed_at": null,
            "baseline_age_difference_seconds": null,
            "tolerance_window_seconds": 129600
          }
        ]
      },
      "PASSPORTS_ISSUED": {
        "status": "LIVE",
        "value": 12,
        "observed_at": "2026-08-24T00:52:14.398Z",
        "provenance": "passport_core",
        "warnings": []
      },
      "PUBLIC_PASSPORTS": {
        "status": "LIVE",
        "value": 0,
        "observed_at": "2026-08-24T00:52:14.398Z",
        "provenance": "passport_core"
      },
      "PRIVATE_PASSPORTS": {
        "status": "LIVE",
        "value": 12,
        "observed_at": "2026-08-24T00:52:14.398Z",
        "provenance": "passport_core"
      },
      "ACTIVE_PASSPORTS": {
        "status": "NOT_DEFINED",
        "value": null,
        "observed_at": null,
        "provenance": "definition_pending"
      },
      "MARCO_MERCHANTS": {
        "status": "PLANNED",
        "value": null,
        "observed_at": null
      },
      "M_CREDITS_CIRCULATING": {
        "status": "PLANNED",
        "value": null,
        "observed_at": null
      }
    },
    "subject_distribution": {
      "HUMAN": 13
    },
    "subject_classification_note": "SELF_DECLARED"
  },
  "canonical_url": "/api/public/marco/metrics"
}