hibachi.vault

Documentation for eth_defi.hibachi.vault Python module.

Hibachi vault data extraction.

This module fetches Hibachi vault metadata and daily share price history from the public data API at https://data-api.hibachi.xyz.

No authentication is required — all data comes from public endpoints.

Endpoints used:

• GET /vault/info — vault metadata (all vaults or filtered by vaultId)

• GET /vault/performance?vaultId={id}&timeRange=All — daily share price history

For full API documentation see eth_defi/hibachi/README.md.

Functions

fetch_vault_info(session[, timeout])	Fetch metadata for all Hibachi vaults.
fetch_vault_performance(session, vault_id[, ...])	Fetch daily share price history for a single Hibachi vault.

Classes

HibachiVaultDailyPrice	One daily price snapshot for a Hibachi vault.
HibachiVaultInfo	Metadata for a Hibachi vault.

class HibachiVaultDailyPrice

Bases: object

One daily price snapshot for a Hibachi vault.

Parsed from the /vault/performance endpoint response.

__init__(vault_id, date, per_share_price, tvl, daily_return)

Parameters

• vault_id (int) –

• date (datetime.date) –

• per_share_price (float) –

• tvl (float) –

• daily_return (Optional[float]) –

Return type

None

class HibachiVaultInfo

Bases: object

Metadata for a Hibachi vault.

Parsed from the /vault/info endpoint response.

• Hibachi vaults page

__init__(vault_id, symbol, short_description, description, per_share_price, outstanding_shares, min_unlock_hours, vault_pub_key, vault_asset_id)

Parameters

• vault_id (int) –

• symbol (str) –

• short_description (str) –

• description (Optional[str]) –

• per_share_price (float) –

• outstanding_shares (float) –

• min_unlock_hours (int) –

• vault_pub_key (str) –

• vault_asset_id (int) –

Return type

None

property address: str

Synthetic pipeline address (hibachi-vault-{vault_id}).

property tvl: float

Current TVL in USDT (perSharePrice × outstandingShares).

fetch_vault_info(session, timeout=30.0)

Fetch metadata for all Hibachi vaults.

Calls GET /vault/info on the public data API.

Parameters

• session (eth_defi.hibachi.session.HibachiSession) – HTTP session.

• timeout (float) – HTTP request timeout in seconds.

Returns

List of vault info objects.

Return type

list[eth_defi.hibachi.vault.HibachiVaultInfo]

fetch_vault_performance(session, vault_id, timeout=30.0)

Fetch daily share price history for a single Hibachi vault.

Calls GET /vault/performance?vaultId={vault_id}&timeRange=All on the public data API.

Only timeRange=All is supported; other values return HTTP 400.

Parameters

• session (eth_defi.hibachi.session.HibachiSession) – HTTP session.

• vault_id (int) – Vault ID to query (e.g. 2 or 3).

• timeout (float) – HTTP request timeout in seconds.

Returns

List of daily price snapshots, sorted by date ascending.

Return type

list[eth_defi.hibachi.vault.HibachiVaultDailyPrice]