# California Highway Traffic Speeds

> California Highway Traffic Speeds is a paid API for AI agents from agentbodega.store, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns real-time average, max, and min traffic speeds for California highways, filterable by region, road, and direction.

## Facts

- Endpoint: POST https://agentbodega.store/api/public-data/california-highway-traffic
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/california-highway-traffic-speeds-76a98182
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LpB3geqJvtPk8_YYdPH9u

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 california-highway-traffic-speeds-76a98182 -d '<json body>'
```

Example prompt: What are the current traffic speeds on Highway 580 eastbound in Northern California — include any incidents and show up to 10 roads?

## When to prefer this

Use this endpoint when you need real-time California highway traffic speed data filtered by specific roads, regions, or directions. Prefer this over general mapping APIs when you need raw sensor-based speed metrics (avg/max/min MPH) for programmatic analysis or alerting, especially for NoCal/SoCal highway corridors. Best suited for agents doing commute monitoring, logistics routing, or traffic anomaly detection in California.

## Known failure modes

- Invalid or unrecognized region string returns empty results or error
- Road name not found returns empty results array
- Malformed integer for minMph or limit may cause validation failure
- x402 payment failure results in 402 response before any data is returned
- Requesting both includeSensors and includeIncidents on large limit may slow response

## How this service works

Small x402-payable utility APIs for agents: endpoint inspection, launch checks, and hosted artifacts.

## Output

Returns a JSON object with a tool metadata block, the queried region, and a results array. Each result includes road name, road ID, direction, average MPH, max MPH, min MPH, and number of sensors. Also returns a success flag.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "body": {
     "fields": [
      {
       "name": "region",
       "type": "string",
       "required": false
      },
      {
       "name": "road",
       "type": "string",
       "required": false
      },
      {
       "name": "direction",
       "type": "string",
       "required": false
      },
      {
       "name": "minMph",
       "type": "integer",
       "required": false
      },
      {
       "name": "includeIncidents",
       "type": "boolean",
       "required": false
      },
      {
       "name": "includeSensors",
       "type": "boolean",
       "required": false
      },
      {
       "name": "limit",
       "type": "integer",
       "required": false
      },
      {
       "name": "proxiesSx",
       "type": "boolean | object",
       "required": false
      }
     ],
     "required": [],
     "fieldCount": 8,
     "contentType": "application/json",
     "optionalPreview": [
      "region",
      "road",
      "direction",
      "minMph",
      "includeIncidents",
      "includeSensors",
      "limit",
      "proxiesSx"
     ],
     "omittedFieldCount": 0
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "object",
     "additionalProperties": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "tool": {
   "id": "california-highway-traffic",
   "name": "California Highway Traffic Speeds",
   "department": "Public Data"
  },
  "region": "NoCal",
  "results": [
   {
    "road": "580",
    "avg_mph": 34.2,
    "max_mph": 61,
    "min_mph": 12,
    "road_id": "100580",
    "sensors": 18,
    "direction": "East"
   }
  ],
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/california-highway-traffic-speeds-76a98182/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentbodega.store](https://www.zero.xyz/host/agentbodega.store/llms.txt)