Optional CoinGecko API price precision

Author: heyajohnny

Version

@@ -25,3 +25,4 @@ Version: 1.0.5 20241219 - Updated help text
 Version: 1.0.6 20241222 - Added 14 day change and 1 year change
 Version: 1.0.7 20241227 - Added ath_price, ath_date and ath_change
 Version: 1.0.8 20260317 - Updated code to support future Home Assistant versions
+Version: 1.0.9 20260322 - Optional CoinGecko API price precision (config + /coins/markets)

custom_components/cryptoinfo/config_flow.py

@@ -1,32 +1,36 @@
 #!/usr/bin/env python3
-"""
-Config flow component for Cryptoinfo
+"""Config flow for Cryptoinfo.
+
 Author: Johnny Visser
 """
 
 from collections.abc import Mapping
 from typing import Any
 
 import voluptuous as vol
+
 from homeassistant import config_entries
 from homeassistant.helpers import config_validation as cv
 
-from .helper.crypto_info_data import CryptoInfoData
-
+from .config_validation import precision as cv_precision
 from .const.const import (
     _LOGGER,
     CONF_CRYPTOCURRENCY_IDS,
     CONF_CURRENCY_NAME,
     CONF_ID,
     CONF_MIN_TIME_BETWEEN_REQUESTS,
     CONF_MULTIPLIERS,
+    CONF_PRECISION,
     CONF_UNIT_OF_MEASUREMENT,
     CONF_UPDATE_FREQUENCY,
     DOMAIN,
 )
+from .helper.crypto_info_data import CryptoInfoData
 
 
 class CryptoInfoConfigFlow(config_entries.ConfigFlow, domain=DOMAIN):
+    """Config flow to add or reconfigure Cryptoinfo entries."""
+
     VERSION = 1
 
     def _validate_input(self, user_input: dict[str, Any]) -> dict[str, Any]:
@@ -51,7 +55,17 @@ def _validate_input(self, user_input: dict[str, Any]) -> dict[str, Any]:
 
         return errors
 
+    def _precision_field_errors(self, user_input: dict[str, Any]) -> dict[str, str]:
+        """Validate CONF_PRECISION (UI schema must stay JSON-serializable)."""
+        errors: dict[str, str] = {}
+        try:
+            user_input[CONF_PRECISION] = cv_precision(user_input.get(CONF_PRECISION, ""))
+        except vol.Invalid:
+            errors[CONF_PRECISION] = "invalid_precision"
+        return errors
+
     async def async_step_reconfigure(self, user_input: Mapping[str, Any] | None = None):
+        """Allow changing an existing Cryptoinfo config entry."""
         entry = self.hass.config_entries.async_get_entry(self.context["entry_id"])
         assert entry
         if user_input:
@@ -63,6 +77,12 @@ async def async_step_reconfigure(self, user_input: Mapping[str, Any] | None = No
                 user_input[CONF_ID] = ""
             if CONF_UNIT_OF_MEASUREMENT not in user_input:
                 user_input[CONF_UNIT_OF_MEASUREMENT] = ""
+            if CONF_PRECISION not in user_input:
+                user_input[CONF_PRECISION] = ""
+
+            prec_errors = self._precision_field_errors(user_input)
+            if prec_errors:
+                return await self._redo_configuration(entry.data, prec_errors)
 
             # Validate the input
             validation_result = self._validate_input(user_input)
@@ -132,6 +152,11 @@ async def _redo_configuration(
                         "suggested_value": entry_data.get(CONF_UNIT_OF_MEASUREMENT, "")
                     },
                 ): str,
+                vol.Optional(
+                    CONF_PRECISION,
+                    default=entry_data.get(CONF_PRECISION, ""),
+                    description={"suggested_value": entry_data.get(CONF_PRECISION, "")},
+                ): str,
                 vol.Required(
                     CONF_UPDATE_FREQUENCY, default=entry_data[CONF_UPDATE_FREQUENCY]
                 ): cv.positive_float,
@@ -171,6 +196,7 @@ async def async_step_user(self, user_input: dict[str, Any] | None = None):
             CONF_UNIT_OF_MEASUREMENT: "$",
             CONF_UPDATE_FREQUENCY: 1,
             CONF_MIN_TIME_BETWEEN_REQUESTS: default_min_time,
+            CONF_PRECISION: "",
         }
 
         # Update defaults with user input if it exists
@@ -197,6 +223,11 @@ async def async_step_user(self, user_input: dict[str, Any] | None = None):
                         "suggested_value": defaults.get(CONF_UNIT_OF_MEASUREMENT, "")
                     },
                 ): str,
+                vol.Optional(
+                    CONF_PRECISION,
+                    default="",
+                    description={"suggested_value": defaults.get(CONF_PRECISION, "")},
+                ): str,
                 vol.Required(
                     CONF_UPDATE_FREQUENCY, default=defaults[CONF_UPDATE_FREQUENCY]
                 ): cv.positive_float,
@@ -213,6 +244,15 @@ async def async_step_user(self, user_input: dict[str, Any] | None = None):
             )
 
         try:
+            prec_errors = self._precision_field_errors(user_input)
+            if prec_errors:
+                errors.update(prec_errors)
+                return self.async_show_form(
+                    step_id="user",
+                    data_schema=cryptoinfo_schema,
+                    errors=errors,
+                )
+
             # Validate the input
             validation_result = self._validate_input(user_input)
             if validation_result:
@@ -237,7 +277,7 @@ async def async_step_user(self, user_input: dict[str, Any] | None = None):
                 title=f"Cryptoinfo for {user_input[CONF_ID]}", data=user_input
             )
 
-        except Exception as ex:
+        except Exception as ex:  # noqa: BLE001
             _LOGGER.error(f"Error creating entry: {ex}")
             errors["base"] = f"Error creating entry: {ex}"
             return self.async_show_form(

custom_components/cryptoinfo/config_validation.py

@@ -0,0 +1,23 @@
+"""Voluptuous validators for Cryptoinfo configuration."""
+
+from typing import Any
+
+import voluptuous as vol
+
+
+def precision(value: Any) -> str:
+    """Normalize CoinGecko `precision` (empty, full, or 0–18)."""
+    if value is None:
+        return ""
+    v = str(value).strip().lower()
+    if not v:
+        return ""
+    if v == "full":
+        return "full"
+    if v.isdigit():
+        n = int(v)
+        if 0 <= n <= 18:
+            return str(n)
+    raise vol.Invalid(
+        "Must be empty (CoinGecko default), full, or a whole number from 0 to 18"
+    )

custom_components/cryptoinfo/const/const.py

@@ -9,6 +9,7 @@
 CONF_UPDATE_FREQUENCY = "update_frequency"
 CONF_UNIT_OF_MEASUREMENT = "unit_of_measurement"
 CONF_MIN_TIME_BETWEEN_REQUESTS = "min_time_between_requests"
+CONF_PRECISION = "precision"
 
 SENSOR_PREFIX = "Cryptoinfo "
 ATTR_LAST_UPDATE = "last_update"

custom_components/cryptoinfo/manifest.json

@@ -1,7 +1,7 @@
 {
   "domain": "cryptoinfo",
   "name": "Cryptoinfo",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "config_flow": true,
   "iot_class": "cloud_polling",
   "documentation": "https://github.com/heyajohnny/cryptoinfo",

custom_components/cryptoinfo/sensor.py

@@ -6,12 +6,13 @@
 
 from datetime import datetime, timedelta
 import urllib.error
+from urllib.parse import urlencode
 
 from aiohttp import ClientError
 
 from homeassistant import config_entries
 from homeassistant.components.sensor import SensorEntity
-from homeassistant.components.sensor.const import SensorDeviceClass, SensorStateClass
+from homeassistant.components.sensor.const import SensorStateClass
 from homeassistant.core import HomeAssistant
 from homeassistant.helpers import aiohttp_client
 from homeassistant.helpers.entity_platform import AddEntitiesCallback
@@ -50,6 +51,7 @@
     CONF_ID,
     CONF_MIN_TIME_BETWEEN_REQUESTS,
     CONF_MULTIPLIERS,
+    CONF_PRECISION,
     CONF_UNIT_OF_MEASUREMENT,
     CONF_UPDATE_FREQUENCY,
     SENSOR_PREFIX,
@@ -75,6 +77,7 @@ async def async_setup_entry(
     min_time_between_requests = timedelta(
         minutes=(float(config.get(CONF_MIN_TIME_BETWEEN_REQUESTS)))
     )
+    precision = (config.get(CONF_PRECISION) or "").strip().lower()
 
     # Create coordinator for centralized data fetching
     coordinator = CryptoDataCoordinator(
@@ -84,6 +87,7 @@ async def async_setup_entry(
         update_frequency,
         min_time_between_requests,
         id_name,
+        precision,
     )
 
     # Wait for coordinator to do first update
@@ -138,6 +142,7 @@ def __init__(
         update_frequency: timedelta,
         min_time_between_requests: timedelta,
         id_name: str,
+        precision: str,
     ):
         """Initialize the coordinator."""
         super().__init__(
@@ -156,6 +161,18 @@ def __init__(
         self.id_name = id_name
         self.min_time_between_requests = min_time_between_requests
         self.update_frequency = update_frequency
+        self.precision = precision
+
+    def _markets_url(self) -> str:
+        """Build the CoinGecko /coins/markets request URL."""
+        params = [
+            ("vs_currency", self.currency_name),
+            ("ids", self.cryptocurrency_ids),
+            ("price_change_percentage", "1h,24h,7d,14d,30d,1y"),
+        ]
+        if self.precision:
+            params.append(("precision", self.precision))
+        return f"{API_ENDPOINT}coins/markets?{urlencode(params)}"
 
     async def async_will_remove_from_hass(self) -> None:
         """Handle removal from Home Assistant."""
@@ -178,12 +195,7 @@ async def _async_update_data(self):
                 f"First request, fetching data for sensor: {self.id_name} instance_id: {self.instance_id} cryptocurrency_ids: {self.cryptocurrency_ids}"
             )
 
-            url = (
-                f"{API_ENDPOINT}coins/markets"
-                f"?ids={self.cryptocurrency_ids}"
-                f"&vs_currency={self.currency_name}"
-                f"&price_change_percentage=1h%2C24h%2C7d%2C14d%2C30d%2C1y"
-            )
+            url = self._markets_url()
 
             try:
                 session = aiohttp_client.async_get_clientsession(self.hass)
@@ -234,12 +246,7 @@ async def _async_update_data(self):
             f"Fetch data from API endpoint, sensor: {self.id_name} instance_id: {self.instance_id} cryptocurrency_ids: {self.cryptocurrency_ids}"
         )
 
-        url = (
-            f"{API_ENDPOINT}coins/markets"
-            f"?ids={self.cryptocurrency_ids}"
-            f"&vs_currency={self.currency_name}"
-            f"&price_change_percentage=1h%2C24h%2C7d%2C14d%2C30d%2C1y"
-        )
+        url = self._markets_url()
 
         try:
             session = aiohttp_client.async_get_clientsession(self.hass)
@@ -274,7 +281,7 @@ def __init__(
         self.cryptocurrency_id = cryptocurrency_id
         self.currency_name = currency_name
         self.multiplier = multiplier
-        self._attr_device_class = SensorDeviceClass.MONETARY
+        # MONETARY + MEASUREMENT is invalid in Home Assistant; spot price is a measurement.
         self._attr_state_class = SensorStateClass.MEASUREMENT
         self._attr_native_unit_of_measurement = unit_of_measurement or None
         # Let Home Assistant generate a valid entity ID (CoinGecko ids can contain '-')

custom_components/cryptoinfo/translations/en.json

@@ -11,7 +11,8 @@
                     "unit_of_measurement": "Unit of measurement",
                     "multipliers": "Multipliers",
                     "update_frequency": "Update Frequency (minutes)",
-                    "min_time_between_requests": "Minimum time between requests (minutes)"
+                    "min_time_between_requests": "Minimum time between requests (minutes)",
+                    "precision": "Price precision"
                 },
                 "data_description": {
                     "id": "Unique name for the sensor.",
@@ -20,7 +21,8 @@
                     "unit_of_measurement": "Do you want to use a currency symbol? ([Symbol list](https://en.wikipedia.org/wiki/Currency_symbol#List_of_currency_symbols_currently_in_use))",
                     "multipliers": "The number of coins/tokens (separated by a comma). The number of multipliers must match the number of cryptocurrency IDs.",
                     "update_frequency": "How often should the value be refreshed? Beware of the [CoinGecko rate limit](https://support.coingecko.com/hc/en-us/articles/4538771776153-What-is-the-rate-limit-for-CoinGecko-API-public-plan) when tracking multiple cryptocurrencies.",
-                    "min_time_between_requests": "The minimum time between the other entities and this entity to make a data request to the API. (This property is shared and the same for every entity.)"
+                    "min_time_between_requests": "The minimum time between the other entities and this entity to make a data request to the API. (This property is shared and the same for every entity.)",
+                    "precision": "Optional. CoinGecko `precision` for currency prices: leave empty for API default, use `full` for full precision, or `0`–`18` for decimal places. See [coins/markets](https://docs.coingecko.com/reference/coins-markets)."
                 }
             },
             "reconfigure": {
@@ -33,7 +35,8 @@
                     "unit_of_measurement": "Unit of measurement",
                     "multipliers": "Multipliers",
                     "update_frequency": "Update Frequency (minutes)",
-                    "min_time_between_requests": "Minimum time between requests (minutes)"
+                    "min_time_between_requests": "Minimum time between requests (minutes)",
+                    "precision": "Price precision"
                 },
                 "data_description": {
                     "id": "Unique name for the sensor.",
@@ -42,7 +45,8 @@
                     "unit_of_measurement": "Do you want to use a currency symbol? ([Symbol list](https://en.wikipedia.org/wiki/Currency_symbol#List_of_currency_symbols_currently_in_use))",
                     "multipliers": "The number of coins/tokens (separated by a comma). The number of multipliers must match the number of cryptocurrency IDs.",
                     "update_frequency": "How often should the value be refreshed? Beware of the [CoinGecko rate limit](https://support.coingecko.com/hc/en-us/articles/4538771776153-What-is-the-rate-limit-for-CoinGecko-API-public-plan) when tracking multiple cryptocurrencies.",
-                    "min_time_between_requests": "The minimum time between the other entities and this entity to make a data request to the API. (This property is shared and the same for every entity.)"
+                    "min_time_between_requests": "The minimum time between the other entities and this entity to make a data request to the API. (This property is shared and the same for every entity.)",
+                    "precision": "Optional. CoinGecko `precision` for currency prices: leave empty for API default, use `full` for full precision, or `0`–`18` for decimal places. See [coins/markets](https://docs.coingecko.com/reference/coins-markets)."
                 }
             }
         },
@@ -52,7 +56,8 @@
         },
         "error": {
             "cannot_connect": "Error: Cannot connect",
-            "mismatch_values": "The number of cryptocurrency id's ({crypto_count}) does not match the number of multipliers ({multiplier_count})"
+            "mismatch_values": "The number of cryptocurrency id's ({crypto_count}) does not match the number of multipliers ({multiplier_count})",
+            "invalid_precision": "Precision must be empty, full, or a whole number from 0 to 18"
         }
     }
 }