# TruthBear Maritime Chokepoint Region Gauge

> TruthBear Maritime Chokepoint Region Gauge is a paid API for AI agents from api.truthbear.co, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-14).

Runs a 4-leg sequential chain assessing current passage conditions at a named maritime chokepoint, aggregating sea state thresholds, anchorage congestion, vessel wait counts, and realized daily transit counts from IMF PortWatch.

## Facts

- Endpoint: GET https://api.truthbear.co/gauge/chokepoint-region
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/truthbear-maritime-chokepoint-region-gauge-6f81a2ab
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_00CNXA1DgKxUqkcKVlKmA

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 truthbear-maritime-chokepoint-region-gauge-6f81a2ab
```

Example prompt: What are the current passage conditions at the Strait of Hormuz — is the sea state within operating thresholds, how many vessels are waiting at anchorage, and what are the realized daily transits?

## When to prefer this

Use this endpoint when you need a multi-signal, sequentially confirmed picture of maritime chokepoint conditions — not just raw vessel counts or a single metric, but a chained assessment that cross-validates sea state, congestion, and realized transit throughput. Prefer it over generic AIS feeds or single-source vessel trackers when you need a confidence-weighted summary grounded in IMF PortWatch confirmation as the final gate.

## Known failure modes

- 422 no_charge returned when any required data source (IMF PortWatch, NOAA, Open-Meteo) is unavailable — caller is not billed
- Invalid or unsupported loc parameter value returns an error
- Partial chain confidence if only some legs return data (e.g. sea state available but transit data missing)
- Network timeout if upstream data providers are slow or unresponsive

## How this service works

[4-LEG] Maritime chokepoint passage chain, one chokepoint (?loc=hormuz, suez, panama, malacca and more): leading sea state against operating thresholds -> current anchorage congestion, vessels waiting -> realized daily transits from IMF PortWatch (confirmation gate). A chain, not one reading: confidence = how many legs are lit, in order. Sources: IMF PortWatch, NOAA, Open-Meteo. Descriptive only, never a forecast or advice. No data -> 422 no_charge, not billed. $0.25 per call.

## Output

A JSON object with up to four sequential chain legs: (1) leading sea state vs operating thresholds, (2) current anchorage congestion level, (3) vessel wait count, and (4) realized daily transit count confirmed by IMF PortWatch. A confidence score indicates how many legs are lit in order. Descriptive only — no forecasts or advice. Returns HTTP 422 with no_charge if data is unavailable.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "loc"
     ],
     "properties": {
      "loc": {
       "type": "string",
       "examples": [
        "suez-redsea",
        "panama-pacific",
        "malacca",
        "hormuz",
        "goodhope",
        "channel"
       ],
       "description": "required - location id; full list at free /gauge/preview",
       "x-accepted-values": {
        "all": "https://api.truthbear.co/schemas/gauge-chokepoint-region.input.json",
        "shown": 6,
        "total": 12
       }
      }
     },
     "additionalProperties": false
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "const": "json"
    },
    "example": {}
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "legs": {
   "transit": {
    "band": null,
    "source_ref": "IMF PortWatch Daily_Chokepoints_Data portid=chokepoint6(Strait of Hormuz,2026-08-21)",
    "record_hash": "sha256:699bbca83ca77e0570a48c767d25e174e37cf51ceed012b13793f3c485ddc1f6"
   },
   "sea_state": {
    "band": null,
    "source_ref": "https://open-meteo.com/en/docs/marine-weather-api",
    "record_hash": "sha256:6210ac5c3a486067756bca585c841541397171e0310cd9bae667b8a848563b5b"
   },
   "congestion": {
    "band": "no-coverage",
    "source_ref": "https://aisstream.io/documentation",
    "record_hash": "sha256:a2a9e86d3147cee9f7ecbeb797ae8717a73f734a04b77af195c0f33874b906cd"
   },
   "disruption": {
    "band": "operable",
    "source_ref": "https://open-meteo.com/en/docs/marine-weather-api",
    "record_hash": "sha256:5ced2956a016d5b4523e3eff6def79ee891f576ead9c805455c0df6b94df2bef"
   }
  },
  "name": "Strait of Hormuz",
  "grade": "screening-level, not decision-grade",
  "scope": {
   "full": "https://api.truthbear.co/scope/v1",
   "verifiability": "unknown",
   "monitoring_not_forecast": true,
   "intelligence_not_command": true
  },
  "nature": "This API supplies data organisation and trend description only. It is not a recommendation to act; the decision is yours. Purely descriptive - no judgement, no prediction. Official source plus record_hash; verify with the free /gauge/verify.",
  "provenance": {
   "freshness": "recent",
   "age_hours_now": 135.4,
   "freshness_basis": "cadence=default; fresh<=24h; recent<=192h; dead_source>1440h; age_basis=request-time(now minus observed_at)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/truthbear-maritime-chokepoint-region-gauge-6f81a2ab/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.truthbear.co](https://www.zero.xyz/host/api.truthbear.co/llms.txt)