---
name: hashgraph-online-market-value
description: "Get the current market value of a vehicle from its VIN using the CarsXE API. Use this when a user asks how much a car is worth, wants to know its value, or is thinking about buying/selling a vehicle."
license: "Apache-2.0"
metadata:
  decimalai-skill-id: "e8326907-1b47-48b0-a04b-2f7b2e0cdcfc"
  decimalai-version-id: "3e039cfd-9dc3-48d7-922e-06cca33af55c"
  decimalai-version: "1"
  decimalai-body-sha256: "0c3879dab5bb9e2587361633732f74d6361ec553cd5bd00e0f1214107a3ece0d"
  decimalai-name: "hashgraph-online/market-value"
  decimalai-format: "1"
  decimalai-invocation: "model"
  decimalai-category: "finance"
  decimalai-source: "https://app.decimal.ai/s/hashgraph-online-market-value@1/SKILL.md"
---
When the user asks about a vehicle's price, worth, or market value and has a VIN:

1. Optionally refine the estimate with these parameters if the user mentions them:
   - `state` — US state code (e.g., `CA`, `TX`) for regional pricing
   - `mileage` — current mileage to adjust the value
   - `condition` — vehicle condition: `excellent`, `clean`, `average`, or `rough`
2. Make an HTTP GET request to the CarsXE Market Value API:
   ```
   GET https://api.carsxe.com/v2/marketvalue?key={CARSXE_API_KEY}&vin={VIN}&source=codex_plugin
   ```
   Append `&state=<STATE>`, `&mileage=<MILEAGE>`, and/or `&condition=<CONDITION>` if provided.
3. Present the estimated market value clearly, including:
   - Current value estimate
   - Low / average / high range if available
   - Historical trend if available
4. Provide helpful context (e.g., whether the value is strong for its age/mileage).
5. If the API key is missing, tell the user to set the `CARSXE_API_KEY` environment variable (see AGENTS.md).