# Halowerk Foot Traffic Retail Performance Scorer

> Halowerk Foot Traffic Retail Performance Scorer is a paid API for AI agents from prop.halowerk.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-14).

Compares observed retail foot-traffic metrics (visits, dwell time, conversions) against caller-supplied baselines and combines the three ratios into a weighted composite score per time interval.

## Facts

- Endpoint: POST https://prop.halowerk.com/v1/foot-traffic-retail
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-foot-traffic-retail-performance-scorer-bc8f1071
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1lfM1shJWSm2NH3Bq7jPr

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 halowerk-foot-traffic-retail-performance-scorer-bc8f1071 -d '<json body>'
```

Example prompt: Score last week's retail performance for intervals mon-morning and sat-afternoon: mon-morning had 420 visits (baseline 500), mean dwell 8.2 min (baseline 10), 38 conversions (baseline conversion rate 0.09), and sat-afternoon had 610 visits (baseline 580), dwell 11.5 min (baseline 10.5), 72 conversions (baseline rate 0.11) — weight visits 0.4, dwell 0.3, conversion 0.3.

## When to prefer this

Choose this endpoint when you have already aggregated retail foot-traffic data and need a fast, deterministic weighted composite score against explicit baselines — without any data collection, demographic inference, or forecasting. It is ideal for post-hoc performance reporting, comparing time intervals, or feeding scores into a broader analytics pipeline. Prefer alternatives if you need raw data ingestion, predictive modelling, or demographic segmentation.

## Known failure modes

- Weights that do not sum to a valid range may be rejected or yield unintuitive scores
- baseline values of zero are not permitted (minimum 0.001); supplying zero baselines returns a validation error
- interval_id strings exceeding 128 characters are rejected
- submitting more than 10,000 intervals in one call returns a payload-too-large error
- missing required fields (visits, mean_dwell_minutes, conversions, any baseline) result in schema validation errors
- non-numeric or negative metric values are rejected

## How this service works

Compares supplied visits, mean dwell time and conversions with explicit baselines and combines the three ratios using caller-supplied weights. It does not collect location data, count people, infer demographics or forecast demand. Inputs should be aggregated and lawfully collected.

## Output

For each submitted interval, the endpoint returns the individual ratios (visits/baseline, dwell/baseline, conversion/baseline) and a single weighted composite score combining all three ratios according to the caller-supplied weights, enabling direct comparison of performance across intervals.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "weights": {
   "type": "object",
   "required": [
    "visits",
    "dwell",
    "conversion"
   ],
   "properties": {
    "dwell": {
     "type": "number",
     "maximum": 1,
     "minimum": 0
    },
    "visits": {
     "type": "number",
     "maximum": 1,
     "minimum": 0
    },
    "conversion": {
     "type": "number",
     "maximum": 1,
     "minimum": 0
    }
   },
   "additionalProperties": false
  },
  "intervals": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "interval_id",
     "visits",
     "mean_dwell_minutes",
     "conversions",
     "baseline_visits",
     "baseline_dwell_minutes",
     "baseline_conversion_rate"
    ],
    "properties": {
     "visits": {
      "type": "integer",
      "maximum": 1000000000,
      "minimum": 0
     },
     "conversions": {
      "type": "integer",
      "maximum": 1000000000,
      "minimum": 0
     },
     "interval_id": {
      "type": "string",
      "maxLength": 128,
      "minLength": 1
     },
     "baseline_visits": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 0.001
     },
     "mean_dwell_minutes": {
      "type": "number",
      "maximum": 100000,
      "minimum": 0
     },
     "baseline_dwell_minutes": {
      "type": "number",
      "maximum": 100000,
      "minimum": 0.001
     },
     "baseline_conversion_rate": {
      "type": "number",
      "maximum": 1,
      "minimum": 0.000001
     }
    },
    "additionalProperties": false
   },
   "maxItems": 10000,
   "minItems": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-foot-traffic-retail-performance-scorer-bc8f1071/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from prop.halowerk.com](https://www.zero.xyz/host/prop.halowerk.com/llms.txt)