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. Priority vault-name matches run first, then exact protocol manager metadata, then ordinary vault-name and manager-name fuzzy matching.

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 (Optional[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 or None 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]