{
  "schema_version": "1",
  "portal_version": "1.0.0-foundation",
  "updated_at": "2026-07-20",
  "source": "marco.public_portal",
  "provenance": "canonical_registry",
  "data": {
    "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."
    },
    "holder_provider_env_hint": {
      "MARCO_HOLDER_DATA_PROVIDER": "string (label)",
      "MARCO_HOLDER_API_URL": "URL template supporting {address}, {chain_id}, {apiKey}",
      "MARCO_HOLDER_API_KEY": "secret — never exposed",
      "MARCO_HOLDER_CACHE_SECONDS": "integer (default 300)",
      "MARCO_HOLDER_STALE_SECONDS": "integer (default 3600)",
      "MARCO_HOLDER_SNAPSHOT_ENABLED": "boolean string",
      "MARCO_TOKEN_CONTRACT_ADDRESS": "0x-prefixed address",
      "MARCO_TOKEN_CHAIN_ID": "integer (default 56 — BNB Smart Chain)",
      "MARCO_TOKEN_DECIMALS": "integer (default 18)",
      "MARCO_TOKEN_EXPLORER_URL": "URL"
    }
  },
  "canonical_url": "/api/public/marco/metrics/provenance"
}