identify_curator

Documentation for eth_defi.vault.curator.identify_curator function.

identify_curator(chain_id, vault_token_symbol, vault_name, vault_address, protocol_slug='', manager_name='')

Identify the curator managing a vault.

Checks protocol-curated status first (by protocol slug and vault address), then falls back to word-boundary regex matching against the vault display name and the manager name.

Some native marketplace protocols (notably GRVT) brand the curator in a separate manager_name field rather than the vault display name — the vault name there is the strategy name (e.g. "Ethereum Moving Average Long/Short") while the curator identity (e.g. "Gerhard - Bitcoin Strategy") is the manager. Pass manager_name so these curators are detected. The vault name is matched first and takes precedence over the manager name.

Parameters
  • chain_id (int) – Chain ID where the vault is deployed.

  • vault_token_symbol (str) – The vault’s share token symbol (e.g. "gtUSDC").

  • vault_name (str) – The vault’s human-readable display name, which curators typically brand with their organisation name.

  • vault_address (str) – The vault’s on-chain address (hex or synthetic format).

  • protocol_slug (str) – Slugified protocol name from eth_defi.research.vault_metrics.slugify_protocol() (e.g. "morpho", "hyperliquid", "lighter").

  • manager_name (str) – Optional name of the vault manager/operator, used by native marketplace protocols (e.g. GRVT) where the curator brand lives in the manager field rather than the vault name. Empty string when unknown.

Returns

Curator slug (e.g. "gauntlet", "ostium", "hyperliquid"), or None if no curator could be identified. For protocol-curated vaults the protocol slug itself is returned. Use is_protocol_curator() to distinguish protocol-curated from third-party curators.

Return type

Optional[str]