Irish Used Car Market Data

Describes this service: what data it has, every tool with its price, and how payment works. Free.

{
  "type": "object",
  "properties": {}
}

Use when you want a ranked list of Irish used-car listings priced below the median of genuinely comparable cars (same make, model, fuel, transmission, within 1 year and 30,000 km). Each result includes the asking price, the market median, number of comparables and the gross margin. Best for dealers, flippers and buying agents looking for opportunities. Costs 0.05 USDC per call via x402; no-data results are free.

{
  "type": "object",
  "properties": {
    "min_margin_eur": {
      "type": "number",
      "description": "Minimum margin in EUR between market median and asking price (after a cost buffer)."
    },
    "make": {
      "type": "string",
      "description": "Only return this make, e.g. BMW."
    },
    "limit": {
      "type": "integer",
      "description": "Maximum results, 1-500.",
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": []
}

Use to poll for fresh opportunities: returns deals first seen by us since a timestamp (default: last 24 hours). Call on a schedule with the previous call's time to receive only new deals. Costs 0.02 USDC per call via x402; no-data results are free.

{
  "type": "object",
  "properties": {
    "since": {
      "type": "string",
      "description": "ISO 8601 timestamp. Defaults to 24 hours ago."
    },
    "min_margin_eur": {
      "type": "number",
      "description": "Minimum margin in EUR."
    },
    "make": {
      "type": "string",
      "description": "Only this make."
    },
    "limit": {
      "type": "integer",
      "description": "Maximum results, 1-500.",
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": []
}

Use to find motivated sellers: listings whose price dropped within the last N days, with original, previous and current price and the percentage cut. Price history is recorded by us from the first time we see a listing. Costs 0.02 USDC per call via x402; no-data results are free.

{
  "type": "object",
  "properties": {
    "days": {
      "type": "integer",
      "description": "Look-back window in days, 1-60.",
      "minimum": 1,
      "maximum": 60
    },
    "min_drop_pct": {
      "type": "number",
      "description": "Minimum size of the latest cut, in percent."
    },
    "limit": {
      "type": "integer",
      "description": "Maximum results, 1-500.",
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": []
}

Use for an overview of one model in the Irish used market: listing count, price range, median, and median price and mileage by model year and by fuel type. Costs 0.01 USDC per call via x402; no-data results are free.

{
  "type": "object",
  "properties": {
    "make": {
      "type": "string",
      "description": "Vehicle make, case-insensitive."
    },
    "model": {
      "type": "string",
      "description": "Vehicle model, case-insensitive."
    }
  },
  "required": [
    "make",
    "model"
  ]
}

Use to estimate depreciation: median price by model year with year-on-year change, plus price change per 10,000 km. Needs at least 5 listings; otherwise returns 404 and you are not charged. Costs 0.01 USDC per call via x402; no-data results are free.

{
  "type": "object",
  "properties": {
    "make": {
      "type": "string",
      "description": "Vehicle make, case-insensitive."
    },
    "model": {
      "type": "string",
      "description": "Vehicle model, case-insensitive."
    },
    "fuel_type": {
      "type": "string",
      "description": "Optional: restrict to one fuel type."
    }
  },
  "required": [
    "make",
    "model"
  ]
}

Use to see where a model (or make, or all cars) is cheapest or dearest across Irish counties, relative to the national median. Small counties may have few listings. Costs 0.01 USDC per call via x402; no-data results are free.

{
  "type": "object",
  "properties": {
    "make": {
      "type": "string",
      "description": "Optional make filter."
    },
    "model": {
      "type": "string",
      "description": "Optional model filter (use with make)."
    }
  },
  "required": []
}

Use to judge a UK import: converts the GBP price and adds shipping, customs duty, import VAT, VRT, NOx levy and a cost buffer to give the landed cost in EUR. Provide make, model, year and mileage to also get the expected margin against the Irish market median. Duty and VAT default to 0 and must be set by the caller; results are estimates. Costs 0.01 USDC per call via x402; no-data results are free.

{
  "type": "object",
  "properties": {
    "uk_price_gbp": {
      "type": "number",
      "description": "UK asking price in GBP."
    },
    "co2_g_km": {
      "type": "integer",
      "description": "WLTP CO2 emissions in g/km (drives the VRT band)."
    },
    "fuel_type": {
      "type": "string",
      "description": "Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid."
    },
    "make": {
      "type": "string",
      "description": "Optional; with model, year and mileage_km enables the margin calculation."
    },
    "model": {
      "type": "string",
      "description": "Optional."
    },
    "year": {
      "type": "integer",
      "description": "Optional model year."
    },
    "mileage_km": {
      "type": "integer",
      "description": "Optional mileage in km."
    },
    "transmission": {
      "type": "string",
      "description": "Optional: Manual or Automatic."
    },
    "shipping_eur": {
      "type": "number",
      "description": "Shipping/transport cost in EUR. Default 600."
    },
    "customs_duty_pct": {
      "type": "number",
      "description": "Customs duty percent. Default 0 (GB-built cars may attract ~10%)."
    },
    "import_vat_pct": {
      "type": "number",
      "description": "Import VAT percent. Default 0; set 23 if it applies."
    },
    "gbp_eur_rate": {
      "type": "number",
      "description": "GBP to EUR rate. Defaults to the service rate."
    },
    "nox_mg_km": {
      "type": "number",
      "description": "NOx mg/km for the NOx levy. Default 40."
    },
    "other_costs_eur": {
      "type": "number",
      "description": "Other costs in EUR. Defaults to the service cost buffer (500)."
    }
  },
  "required": [
    "uk_price_gbp",
    "co2_g_km",
    "fuel_type"
  ]
}

Use to assess one listing you already have an id for: verdict (below/at/above market), percentage vs the comparable median, margin, up to 10 closest comparable listings and the listing's recorded price history. Costs 0.01 USDC per call via x402; no-data results are free.

{
  "type": "object",
  "properties": {
    "source_platform": {
      "type": "string",
      "description": "Source of the listing, currently always 'carzone'."
    },
    "listing_id": {
      "type": "string",
      "description": "The listing's id as returned by the other endpoints."
    }
  },
  "required": [
    "source_platform",
    "listing_id"
  ]
}

Use to value a specific car: median, mean, quartiles and range of comparable Irish listings (same make, model, fuel, transmission if given, within 1 year and 30,000 km). Returns 404 (no charge) if there are fewer than 5 comparables. Costs 0.005 USDC per call via x402; no-data results are free.

{
  "type": "object",
  "properties": {
    "make": {
      "type": "string",
      "description": "Vehicle make, case-insensitive."
    },
    "model": {
      "type": "string",
      "description": "Vehicle model, case-insensitive."
    },
    "year": {
      "type": "integer",
      "description": "Model year.",
      "minimum": 1950,
      "maximum": 2100
    },
    "mileage_km": {
      "type": "integer",
      "description": "Odometer reading in km.",
      "minimum": 0
    },
    "fuel_type": {
      "type": "string",
      "description": "Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid."
    },
    "transmission": {
      "type": "string",
      "description": "Optional: Manual or Automatic."
    }
  },
  "required": [
    "make",
    "model",
    "year",
    "mileage_km",
    "fuel_type"
  ]
}

Use to estimate Vehicle Registration Tax and the NOx levy for a vehicle registered in Ireland, from its taxable value (OMSP), CO2 emissions and fuel type. Estimate only; verify against Revenue.ie. Free (limited to 10 calls per day per IP).

{
  "type": "object",
  "properties": {
    "price_eur": {
      "type": "number",
      "description": "Open market selling price (OMSP) in EUR.",
      "minimum": 0
    },
    "co2_g_km": {
      "type": "integer",
      "description": "WLTP CO2 in g/km.",
      "minimum": 0,
      "maximum": 1000
    },
    "fuel_type": {
      "type": "string",
      "description": "Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid."
    },
    "nox_mg_km": {
      "type": "number",
      "description": "NOx in mg/km. Default 40.",
      "minimum": 0
    }
  },
  "required": [
    "price_eur",
    "co2_g_km",
    "fuel_type"
  ]
}

Use when you already have a listing id (from another call or a dealer site) and want that single vehicle: make, model, year, price, mileage, status and days on market, how its price compares with the market median, and an indicative VRT breakdown. Returns one row. For ranked below-market deals across all stock use get_irish_auto_arbitrage_feed. Free (limited to 10 calls per day per IP).

{
  "type": "object",
  "properties": {
    "listing_id": {
      "type": "string",
      "description": "The listing id as returned by other tools, e.g. a Carzone ad id or a dealer stock id."
    },
    "source_platform": {
      "type": "string",
      "description": "Optional source (carzone, joeduffy, windsor, frankkeane, spirit, denismahony). Only needed when the same id exists on more than one source."
    }
  },
  "required": [
    "listing_id"
  ]
}