DenominationTokenRate

Documentation for eth_defi.feed.stablecoin_rate.DenominationTokenRate Python class.

class DenominationTokenRate

Bases: object

Rate data section exported for a vault denomination token.

This dataclass is returned by StablecoinRateFeeder.get_denomination_token_rate_section() and is serialised by eth_defi.research.vault_metrics.export_lifetime_row() for the denomination_token_rate field in lifetime metrics JSON output. Source-currency values originate from eth_defi.stablecoin_metadata.StablecoinMetadata and are updated by refresh_stablecoin_rates().

Attributes summary

coingecko_id	CoinGecko coin id used to fetch usd_rate.
source_currency	Stablecoin source currency ticker, e.g.
usd_rate	Latest token price in USD from CoinGecko.
usd_rate_fetched_at	Naive UTC timestamp when usd_rate was fetched.
usd_rate_source	Provider/source for usd_rate.
native_rate	Latest token price in source_currency for non-USD stablecoins.
native_rate_currency	Currency ticker for native_rate.
native_rate_fetched_at	Naive UTC timestamp for native_rate.
native_rate_source	Provider chain for native_rate, e.g.
source_currency_usd_rate	USD per one source_currency unit used to derive native_rate.
source_currency_usd_rate_fetched_at	Naive UTC timestamp when source_currency_usd_rate was read from the currency database.
source_currency_usd_rate_source	Currency database provider/source for source_currency_usd_rate.

Methods summary

__init__(coingecko_id, source_currency, ...)

coingecko_id: Optional[str]

CoinGecko coin id used to fetch usd_rate.

source_currency: Optional[str]

Stablecoin source currency ticker, e.g. usd, eur or jpy.

usd_rate: Optional[float]

Latest token price in USD from CoinGecko.

usd_rate_fetched_at: Optional[datetime.datetime]

Naive UTC timestamp when usd_rate was fetched.

usd_rate_source: Optional[str]

Provider/source for usd_rate. Currently coingecko when present.

native_rate: Optional[float]

Latest token price in source_currency for non-USD stablecoins.

This is omitted for source_currency == "usd" because usd_rate already carries the native value.

native_rate_currency: Optional[str]

Currency ticker for native_rate. Populated only for non-USD source currencies.

native_rate_fetched_at: Optional[datetime.datetime]

Naive UTC timestamp for native_rate. Matches usd_rate_fetched_at when populated.

native_rate_source: Optional[str]

Provider chain for native_rate, e.g. coingecko+fawazahmed0.

source_currency_usd_rate: Optional[float]

USD per one source_currency unit used to derive native_rate.

source_currency_usd_rate_fetched_at: Optional[datetime.datetime]

Naive UTC timestamp when source_currency_usd_rate was read from the currency database.

source_currency_usd_rate_source: Optional[str]

Currency database provider/source for source_currency_usd_rate.

__init__(coingecko_id, source_currency, usd_rate, usd_rate_fetched_at, usd_rate_source, native_rate, native_rate_currency, native_rate_fetched_at, native_rate_source, source_currency_usd_rate, source_currency_usd_rate_fetched_at, source_currency_usd_rate_source)

Parameters

• coingecko_id (Optional[str]) –

• source_currency (Optional[str]) –

• usd_rate (Optional[float]) –

• usd_rate_fetched_at (Optional[datetime.datetime]) –

• usd_rate_source (Optional[str]) –

• native_rate (Optional[float]) –

• native_rate_currency (Optional[str]) –

• native_rate_fetched_at (Optional[datetime.datetime]) –

• native_rate_source (Optional[str]) –

• source_currency_usd_rate (Optional[float]) –

• source_currency_usd_rate_fetched_at (Optional[datetime.datetime]) –

• source_currency_usd_rate_source (Optional[str]) –

Return type

None