StablecoinRateTarget

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

class StablecoinRateTarget

Bases: object

One stablecoin YAML entry that may be refreshed from CoinGecko.

Attributes summary

yaml_path
entry_index
slug
symbol
category
name
coingecko_id
coingecko_link
coingecko_id_source
coingecko_id_verified_at
coingecko_id_verification_failed_at
coingecko_id_verification_failed_reason
source_currency	Curated source currency ticker read from eth_defi.stablecoin_metadata.StablecoinMetadata.
source_currency_source	Source of source_currency.
source_currency_usd_rate	USD per one source_currency unit from the local currency database.
source_currency_usd_rate_date	Calendar date of source_currency_usd_rate.
source_currency_usd_rate_fetched_at	Naive UTC timestamp when source_currency_usd_rate was read.
source_currency_usd_rate_source	Currency API source column used for source_currency_usd_rate.
peg_currency
usd_rate
usd_rate_fetched_at
usd_rate_updated_at
peg_rate
peg_rate_currency
rate_fetch_failed_at
rate_fetch_failed_reason
depegged_at
contract_addresses
ambiguous_symbol	The ticker is reused by unrelated tokens, so never match this entry by symbol — only by contract address.
non_evm	The token has no ERC-20 deployment on any chain we index, so it can never denominate an EVM vault and there is nothing to blacklist.

Methods summary

__init__(yaml_path, entry_index, slug, ...)

source_currency: Optional[str]

Curated source currency ticker read from eth_defi.stablecoin_metadata.StablecoinMetadata.

source_currency_source: Optional[str]

Source of source_currency. Only manual values drive depeg checks.

source_currency_usd_rate: Optional[float]

USD per one source_currency unit from the local currency database.

source_currency_usd_rate_date: Optional[datetime.date]

Calendar date of source_currency_usd_rate.

source_currency_usd_rate_fetched_at: Optional[datetime.datetime]

Naive UTC timestamp when source_currency_usd_rate was read.

source_currency_usd_rate_source: Optional[str]

Currency API source column used for source_currency_usd_rate.

ambiguous_symbol: bool

The ticker is reused by unrelated tokens, so never match this entry by symbol — only by contract address. Set ambiguous_symbol: true in the YAML for tickers such as sUSD or USDR that several distinct tokens share, otherwise marking one depegged would blacklist the healthy ones.

non_evm: bool

The token has no ERC-20 deployment on any chain we index, so it can never denominate an EVM vault and there is nothing to blacklist. Set non_evm: true in the YAML for natively non-EVM tokens (e.g. Acala aUSD on Polkadot, Kava USDX on Cosmos) to silence the otherwise-unactionable depeg warning, which no contract_addresses entry could ever resolve.

__init__(yaml_path, entry_index, slug, symbol, category, name, coingecko_id, coingecko_link, coingecko_id_source, coingecko_id_verified_at, coingecko_id_verification_failed_at, coingecko_id_verification_failed_reason, source_currency, source_currency_source, source_currency_usd_rate, source_currency_usd_rate_date, source_currency_usd_rate_fetched_at, source_currency_usd_rate_source, peg_currency, usd_rate, usd_rate_fetched_at, usd_rate_updated_at, peg_rate, peg_rate_currency, rate_fetch_failed_at, rate_fetch_failed_reason, depegged_at, contract_addresses, ambiguous_symbol=False, non_evm=False)

Parameters

• yaml_path (pathlib.Path) –

• entry_index (Optional[int]) –

• slug (str) –

• symbol (str) –

• category (str) –

• name (str) –

• coingecko_id (Optional[str]) –

• coingecko_link (Optional[str]) –

• coingecko_id_source (Optional[str]) –

• coingecko_id_verified_at (Optional[datetime.datetime]) –

• coingecko_id_verification_failed_at (Optional[datetime.datetime]) –

• coingecko_id_verification_failed_reason (Optional[str]) –

• source_currency (Optional[str]) –

• source_currency_source (Optional[str]) –

• source_currency_usd_rate (Optional[float]) –

• source_currency_usd_rate_date (Optional[datetime.date]) –

• source_currency_usd_rate_fetched_at (Optional[datetime.datetime]) –

• source_currency_usd_rate_source (Optional[str]) –

• peg_currency (Optional[str]) –

• usd_rate (Optional[float]) –

• usd_rate_fetched_at (Optional[datetime.datetime]) –

• usd_rate_updated_at (Optional[datetime.datetime]) –

• peg_rate (Optional[float]) –

• peg_rate_currency (Optional[str]) –

• rate_fetch_failed_at (Optional[datetime.datetime]) –

• rate_fetch_failed_reason (Optional[str]) –

• depegged_at (Optional[datetime.datetime]) –

• contract_addresses (list[tuple[int, str]]) –

• ambiguous_symbol (bool) –

• non_evm (bool) –

Return type

None