# Teuerung Basket Inflation Modeler

> Teuerung Basket Inflation Modeler is a paid API for AI agents from teuerung.halowerk.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-21).

Models weighted-basket inflation by blending official category indices with user-supplied expenditure weights for a given country.

## Facts

- Endpoint: POST https://teuerung.halowerk.com/v1/basket-inflation?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/teuerung-basket-inflation-modeler-b96650e5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_snkBe2w3NiXLolzvFkLPi

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability teuerung-basket-inflation-modeler-b96650e5 -d '<json body>'
```

Example prompt: Model my basket inflation for Germany using these two categories: bread with a weight of 300 and dairy with a weight of 150 — show me the blended rate and flag any missing components.

## When to prefer this

Choose this endpoint when you need a custom, transparency-first inflation model driven by user-supplied spending weights rather than a fixed national basket. It is ideal when the official CPI does not reflect a specific household's or business's actual expenditure mix, and when auditability of reference periods and missing components matters. Prefer it over generic CPI lookup endpoints when the user wants to personalise or stress-test inflation exposure by category.

## Known failure modes

- Unknown or unsupported category string returns an error or null contribution for that item
- Geo code not covered by available HICP data results in a 404 or empty index
- Weights summing to zero cause a division error or undefined rate
- Exceeding 25 items in the basket array triggers a validation error
- Missing required 'category' field on any item causes a 400 bad request
- Categories with no recent index data are flagged as missing components rather than silently dropped

## How this service works

Model inflation from category indices and supplied expenditure weights, not an observed household shopping bill. Example: geo DE with weighted bread and dairy categories. The category-index model, reference periods and missing components remain explicit.

## Output

Returns a modelled inflation rate for the supplied weighted basket, including individual category index contributions, the reference period used, and explicit flags for any missing or unavailable components — making the methodology fully transparent.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "geo": {
   "type": "string",
   "default": "DE",
   "maxLength": 9,
   "minLength": 2
  },
  "items": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "category"
    ],
    "properties": {
     "weight": {
      "type": "number",
      "maximum": 1000,
      "minimum": 0
     },
     "category": {
      "type": "string",
      "maxLength": 60,
      "minLength": 2
     },
     "monthly_spend_eur": {
      "type": "number",
      "maximum": 100000,
      "minimum": 0
     }
    },
    "additionalProperties": false
   },
   "maxItems": 25,
   "minItems": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/teuerung-basket-inflation-modeler-b96650e5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from teuerung.halowerk.com](https://www.zero.xyz/host/teuerung.halowerk.com/llms.txt)