# Halowerk Edge Compute Bid Ranker

> Halowerk Edge Compute Bid Ranker is a paid API for AI agents from iot.halowerk.com, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-14).

Filters edge compute provider candidates by CPU, memory, and latency constraints, computes total workload cost from quoted unit prices, and returns feasible candidates ranked by cost then latency.

## Facts

- Endpoint: POST https://iot.halowerk.com/v1/edge-compute-bid
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/halowerk-edge-compute-bid-ranker-f5aedf0d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tnbe7eiukroHAKzTRp6J0

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-edge-compute-bid-ranker-f5aedf0d -d '<json body>'
```

Example prompt: I need to rank these edge compute providers for a job that requires 120 CPU seconds and 80 GB-seconds of memory, with a maximum latency of 200ms — filter out anyone who can't meet those specs and sort the rest by total cost first, then latency.

## When to prefer this

Use this endpoint when you have a pre-collected set of edge compute provider quotes and need deterministic, cost-ranked filtering against a specific workload spec (CPU seconds, memory GB-seconds, max latency). It is ideal for agent workflows that gather bids from multiple IoT or edge providers and need a fast, reproducible ranking without contacting providers directly or performing hardware attestation. Prefer alternatives if you need live provider discovery, hardware verification, or actual bid placement.

## Known failure modes

- No candidates meet the CPU, memory, or latency constraints — returns empty ranked list
- Invalid or missing required fields such as cpu_seconds or candidates array — returns validation error
- Candidate array is empty or exceeds 1000 items — schema validation rejection
- Negative or zero cpu_seconds provided — schema minimum violation
- Provider name exceeds 128 characters — schema length violation

## How this service works

Filters caller-supplied bids by CPU, memory and latency constraints, computes workload cost from quoted unit prices, and ranks feasible candidates by total cost then latency. It does not contact providers, attest hardware or place a bid.

## Output

A ranked list of feasible provider candidates that satisfy the CPU seconds, memory GB-seconds, and latency constraints, ordered by total computed workload cost (unit price × required quantity) and then by latency. Infeasible candidates that fail to meet resource or latency requirements are excluded from results.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "candidates": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "provider",
     "available_cpu_seconds",
     "available_memory_gb_seconds",
     "latency_ms",
     "price_per_cpu_second",
     "price_per_memory_gb_second"
    ],
    "properties": {
     "provider": {
      "type": "string",
      "maxLength": 128,
      "minLength": 1
     },
     "latency_ms": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 0
     },
     "price_per_cpu_second": {
      "type": "number",
      "maximum": 1000000,
      "minimum": 0
     },
     "available_cpu_seconds": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": 0
     },
     "price_per_memory_gb_second": {
      "type": "number",
      "maximum": 1000000,
      "minimum": 0
     },
     "available_memory_gb_seconds": {
      "type": "number",
      "maximum": 1000000000000000,
      "minimum": 0
     }
    },
    "additionalProperties": false
   },
   "maxItems": 1000,
   "minItems": 1
  },
  "cpu_seconds": {
   "type": "number",
   "maximum": 1000000000,
   "minimum": 0.001
  },
  "max_latency_ms": {
   "type": "number",
   "maximum": 1000000000,
   "minimum": 0
  },
  "memory_gb_seconds": {
   "type": "number",
   "maximum": 1000000000000,
   "minimum": 0
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/halowerk-edge-compute-bid-ranker-f5aedf0d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from iot.halowerk.com](https://www.zero.xyz/host/iot.halowerk.com/llms.txt)