{"uid":"cap_4JqyK9VhcAd-c5KXleC2-","slug":"truthbear-shipping-region-gauge-6038b48e","name":"TruthBear Shipping Region Gauge","description":"[3-LEG] Shipping chokepoint chain, one chokepoint or port (?loc=malacca): leading sea state and wind against operating thresholds -> current wave decomposition, local storm against distant swell -> realized AIS transit throughput (confirmation gate). A chain, not one reading: confidence = how many legs are lit, in order. Sources: IMF PortWatch, NOAA, Open-Meteo Marine. Descriptive only, never a forecast or advice. No data -> 422 no_charge, not billed. $0.25 per call.","url":"https://api.truthbear.co/gauge/shipping-region","method":"GET","headers":{},"bodySchema":{"$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-shipping-region.input.json","shown":6,"total":12}}},"additionalProperties":false}}},"output":{"type":"object","required":["type"],"properties":{"type":{"const":"json"},"example":{}}}}},"responseSchema":{"type":"json","example":{"legs":{"sea_state":{"band":null,"source_ref":"https://open-meteo.com/en/docs/marine-weather-api","record_hash":"sha256:a69ae225e6aa376b3bfa3d9e9a8dd435783ca62c149e599621be7f311ca1e329"},"throughput":{"band":"no-coverage","source_ref":"https://aisstream.io/documentation","record_hash":"sha256:ae1dd2720dd4ae4d8ca046122b1e250d5646968a1cf5aec3af06d4e179bffa1e"},"route_disruption":{"band":"operable","source_ref":"https://open-meteo.com/en/docs/marine-weather-api","record_hash":"sha256:713b0c84338039b1860da52058d9089cc1f2b32404a575bf3d5a550023bf0cb9"}},"name":"Suez / Red Sea approach","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.","location":"suez-redsea","provenance":{"freshness":"fresh","age_hours_now":15,"freshness_basis":"cadence=default; fresh<=24h; recent<=192h; dead_source>1440h; age_basis=request-time(now minus observed_at)"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5oyUuMzu9Jm7D2ZEdMa56","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Runs a 3-leg sequential chain (sea state/wind → wave decomposition/storm vs swell → AIS transit throughput) to assess current shipping chokepoint conditions at a specified location.","exampleAgentPrompt":"Can you pull the current shipping chokepoint gauge for the Malacca Strait — I want to see all three legs: sea state vs wind thresholds, wave decomposition including storm vs distant swell, and the realized AIS transit throughput, plus how many legs are lit for confidence?","exampleUseCases":[{"title":"Chokepoint disruption alert for logistics team","prompt":"Run the shipping gauge for the Suez Red Sea corridor right now and tell me how many of the three legs are lit — I need to know if sea conditions and AIS throughput are within normal thresholds before we route a shipment."},{"title":"Commodity trading desk chokepoint check","prompt":"What does the TruthBear shipping gauge show for Hormuz right now? I want the sea state and wind leg, the wave decomposition leg, and the AIS throughput confirmation, plus the overall confidence based on how many legs are active."},{"title":"Maritime risk monitoring for insurance underwriter","prompt":"Pull the current three-leg shipping gauge for Cape of Good Hope — I need the leading sea state reading, whether it's local storm or distant swell driving wave conditions, and what realized AIS transit throughput looks like right now."}],"resultDescription":"A JSON response containing up to three sequential gauge readings: (1) leading sea state and wind vs operating thresholds, (2) current wave decomposition distinguishing local storm from distant swell, and (3) realized AIS transit throughput as a confirmation gate. Each leg is either lit or unlit, and overall confidence is expressed as the count of consecutive lit legs. Returns a 422 no_charge error with no billing if data is unavailable. Descriptive only — not a forecast or advice.","failureModes":["422 no_charge: no data available for the requested location — not billed","Invalid loc parameter: unknown or unsupported location ID — check /gauge/preview for full list","Partial confidence: one or more legs unlit due to missing upstream data from IMF PortWatch, NOAA, or Open-Meteo Marine","Network timeout or upstream source unavailability resulting in incomplete chain response"],"whenToPreferThis":"Choose this endpoint when you need a real-time, multi-signal descriptive assessment of conditions at a specific global shipping chokepoint, aggregating sea state, wave physics, and AIS throughput into a single confidence-weighted chain. Prefer it over single-source weather or AIS APIs when you want corroborating legs rather than one signal, and over forecast services when a current descriptive reading is sufficient. Best when monitoring known chokepoints (Malacca, Suez, Hormuz, Panama, Good Hope, English Channel) for logistics routing decisions or risk assessment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:33:59.836Z","isFirstParty":false}