{"uid":"cap_EKYXvSJaieyEEZZwQlNFW","slug":"tbs-weather-climate-api-marine-forecast-c0e65d33","name":"TBS Weather & Climate API – Marine Forecast","description":"Marine weather and sea-state forecast for any coastal coordinate. Returns significant wave height, wave direction and period, wind waves, swell (height, direction, period) and ocean current velocity and direction. Oceanographic conditions for shipping, offshore, maritime safety, fishing, surfing and coastal operations.","url":"https://x402.tbs-digital.com/weather/marine?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"lat":{"type":"number","description":"Latitude -90..90 (requires lon)"},"lon":{"type":"number","description":"Longitude -180..180 (requires lat)"},"city":{"type":"string","description":"City name (alternative to lat/lon)"},"timezone":{"type":"string","description":"Optional IANA timezone"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"payer":{"type":"object","properties":{"address":{"type":"string","nullable":true},"network":{"type":"string"}}},"marine":{"type":"object"},"source":{"type":"string"},"location":{"type":"object","properties":{"lat":{"type":"number"},"lon":{"type":"number"},"name":{"type":"string"},"country":{"type":"string"}}},"request_id":{"type":"string"},"generated_at":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"payer":{"address":"0x0000000000000000000000000000000000000000","network":"base"},"marine":{"wave_height_m":0.38,"wave_period_s":4.7,"wave_direction_deg":229,"swell_wave_height_m":0.2,"swell_wave_period_s":5.7,"swell_wave_direction_deg":256,"ocean_current_velocity_kmh":0.4,"ocean_current_direction_deg":63},"source":"open-meteo","location":{"lat":48.65,"lon":-2.01,"name":"Saint-Malo","country":"FR"},"request_id":"0b21c0e6-6a3f-4e2a-8b1e-2f9d4c7a1e55","generated_at":"2026-08-09T12:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_jLBLn_ttZvi5fZSvsjtSU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns marine weather and sea-state forecasts for any coastal coordinate, including wave height/direction/period, swell, wind waves, and ocean current data.","exampleAgentPrompt":"What are the current wave and swell conditions at coordinates 36.15°N, -122.03°W? I need significant wave height, wave direction, swell height and period, and ocean current speed.","exampleUseCases":[{"title":"Surf conditions check for weekend trip","prompt":"Can you pull the marine forecast for Mavericks near Half Moon Bay, California — I need wave height, swell period, and swell direction for this Saturday?"},{"title":"Offshore shipping route sea-state assessment","prompt":"Get me the sea-state forecast for 51.5°N, 3.2°E in the North Sea — I need significant wave height, wave direction, and ocean current velocity for our cargo vessel routing tomorrow."},{"title":"Coastal fishing trip planning","prompt":"What are the ocean conditions like near Montauk, New York? I need wave height, wind waves, and current direction to decide if it's safe to take the boat out."}],"resultDescription":"A JSON object containing the queried location (lat, lon, name, country), a marine weather forecast object with significant wave height, wave direction and period, wind wave metrics, swell height/direction/period, and ocean current velocity and direction, plus a generated_at timestamp, source identifier, request_id, and payer info.","failureModes":["Missing or invalid lat/lon coordinates returns an error — both lat and lon are required together","City name not recognized returns a location resolution error","Coordinates too far inland (non-coastal) may return empty or unavailable marine data","Rate limiting or payment failure returns a 402 Payment Required response","Invalid timezone string returns a parameter error"],"whenToPreferThis":"Choose this endpoint when you need detailed marine and oceanographic forecasts — wave height, swell, and ocean currents — for coastal or offshore coordinates. It is the right choice for maritime safety, shipping routing, surf forecasting, fishing, and any ocean-facing operational context. Prefer it over generic weather endpoints when wave and sea-state data are essential rather than atmospheric conditions alone.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T00:53:59.476Z","isFirstParty":false,"canonicalSlug":"tbs-weather-climate-api-marine-forecast-c0e65d33"}