gauge/chokepoint-region
GET api.truthbear.co/gauge/chokepoint-region
Why an agent can trust this route.
Sonar evidence is advisory. Paid delivery is shown as verified only when paid probes are available; otherwise route estimates use the unpaid handshake as a clearly labeled proxy.
Observed outcomes
[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 sequential 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.
Resource: api.truthbear.co/gauge/chokepoint-region
Network: base · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0x2d16a243ba9fAcC6AC85519d5efad2149DC4C6c3
Payment methods: — · Last validation: 2026-10-15 11:56:57.35+00
{
"input": null,
"output": null,
"paymentRequirements": [
{
"raw": {
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0x2d16a243ba9fAcC6AC85519d5efad2149DC4C6c3",
"amount": "250000",
"scheme": "exact",
"network": "base",
"mimeType": "application/json",
"resource": "https://api.truthbear.co/gauge/chokepoint-region",
"extensions": {
"bazaar": {
"info": {
"input": {
"type": "http",
"method": "GET",
"queryParams": {
"loc": "required - location id; full list at free /gauge/preview"
}
},
"output": {
"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)"
}
}
}
},
"schema": {
"$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": {}
}
}
}
},
"priceUsd": "$0.25",
"discoverable": true,
"outputSchema": {
"type": "object",
"required": [
"legs",
"provenance"
],
"properties": {
"legs": {
"type": "object",
"properties": {
"transit": {
"type": [
"object",
"null"
],
"description": "Realized transits observed (main leg)."
},
"sea_state": {
"type": [
"object",
"null"
],
"description": "Sea/weather workability (upstream cause leg)."
},
"congestion": {
"type": [
"object",
"null"
],
"description": "Anchorage congestion (upstream leg)."
},
"disruption": {
"type": [
"object",
"null"
],
"description": "Route disruption (downstream cross-check leg)."
}
},
"description": "The three-plus legs of this chokepoint, each the latest stored reading or null."
},
"name": {
"type": "string",
"description": "Human-readable name of the chokepoint."
},
"note": {
"type": "string",
"description": "Descriptive-only statement of what was restated and from whom."
},
"chokepoint": {
"type": "string",
"description": "The chokepoint id that was requested."
},
"provenance": {
"type": "object",
"description": "served_from, data_as_of, oldest_leg_as_of, age_hours_now, freshness."
}
},
"conditionalProperties": {
"last_fact": {
"type": [
"object",
"null"
],
"description": "Most recent qualifying fact for this line and entity, attached centrally (may be absent when the line has no qualifying fact yet)"
},
"decision_points": {
"type": [
"object",
"null"
],
"description": "Swappable decision points for this entity, attached centrally: {count, points:[{tag,current,swappable,how}], note}. Present only when the entity has at least one swappable tag in the index, so bundles for entities without one omit it"
},
"leg_availability": {
"type": [
"object",
"null"
],
"description": "Per-leg degradation disclosure: which legs are present, which are degraded and why. Present only when at least one leg is degraded"
},
"record_hash_verifiable": {
"type": [
"object",
"null"
],
"description": "Whether this response can recompute its own record_hash offline. Present only when the payload carries a top-level record_hash; may be absent on list-shaped deliveries where verifiability is stated per row instead"
}
}
},
"routeTemplate": "/gauge/chokepoint-region",
"priceUsdNumber": 0.25
}
},
"description": "[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.",
"outputSchema": {
"input": {
"type": "http",
"method": "GET",
"example": {
"loc": "hormuz",
"format": "thin"
},
"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
}
}
},
"queryParams": {
"loc": "required - location id; full list at free /gauge/preview"
},
"discoverable": true,
"exampleRequest": "/gauge/chokepoint-region?loc=hormuz&format=thin"
},
"output": {
"type": "object",
"required": [
"legs",
"provenance"
],
"properties": {
"legs": {
"type": "object",
"properties": {
"transit": {
"type": [
"object",
"null"
],
"description": "Realized transits observed (main leg)."
},
"sea_state": {
"type": [
"object",
"null"
],
"description": "Sea/weather workability (upstream cause leg)."
},
"congestion": {
"type": [
"object",
"null"
],
"description": "Anchorage congestion (upstream leg)."
},
"disruption": {
"type": [
"object",
"null"
],
"description": "Route disruption (downstream cross-check leg)."
}
},
"description": "The three-plus legs of this chokepoint, each the latest stored reading or null."
},
"name": {
"type": "string",
"description": "Human-readable name of the chokepoint."
},
"note": {
"type": "string",
"description": "Descriptive-only statement of what was restated and from whom."
},
"chokepoint": {
"type": "string",
"description": "The chokepoint id that was requested."
},
"provenance": {
"type": "object",
"description": "served_from, data_as_of, oldest_leg_as_of, age_hours_now, freshness."
}
},
"conditionalProperties": {
"last_fact": {
"type": [
"object",
"null"
],
"description": "Most recent qualifying fact for this line and entity, attached centrally (may be absent when the line has no qualifying fact yet)"
},
"decision_points": {
"type": [
"object",
"null"
],
"description": "Swappable decision points for this entity, attached centrally: {count, points:[{tag,current,swappable,how}], note}. Present only when the entity has at least one swappable tag in the index, so bundles for entities without one omit it"
},
"leg_availability": {
"type": [
"object",
"null"
],
"description": "Per-leg degradation disclosure: which legs are present, which are degraded and why. Present only when at least one leg is degraded"
},
"record_hash_verifiable": {
"type": [
"object",
"null"
],
"description": "Whether this response can recompute its own record_hash offline. Present only when the payload carries a top-level record_hash; may be absent on list-shaped deliveries where verifiability is stated per row instead"
}
}
}
},
"maxAmountRequired": "250000",
"maxTimeoutSeconds": 300
},
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"payTo": "0x2d16a243ba9fAcC6AC85519d5efad2149DC4C6c3",
"scheme": "exact",
"network": "base",
"amountAtomic": "250000"
}
]
}Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.