{"buoys":{"path":"/marine/buoys","method":"GET","kind":"data","tier":"basic","description":"Nearest buoy observations to a location — wave height, period, water temperature, and wind.","parameters":{"latitude":{"type":"number","description":"Latitude (-90 to 90)"},"longitude":{"type":"number","description":"Longitude (-180 to 180)"},"radius_km":{"type":"number","description":"Search radius in km","default":200}},"required":["latitude","longitude"],"output_example":{"location":{"lat":35.0,"lon":-75.0},"nearest_buoy":{"id":"41004","name":"Edisto - 41 NM South of Charleston, SC","distance_km":52.5},"observations":{"wave_height_m":1.5,"wave_period_s":6.0,"water_temp_c":25.0}},"latency_class":"fast"},"port":{"path":"/marine/port","method":"GET","kind":"data","tier":"basic","description":"Get a specific port by UN/LOCODE (e.g. SG-SIN, NL-RTM, US-LAX) or name.","parameters":{"locode":{"type":"string","description":"UN/LOCODE (Country-Location e.g. 'SG-SIN') or port name"}},"required":["locode"],"output_example":{"country":"SG","locode":"SG-SIN","name":"Singapore","lat":1.2833,"lon":103.85},"latency_class":"fast"},"ports":{"path":"/marine/ports","method":"GET","kind":"data","tier":"basic","description":"Search maritime ports by name, country, or UN/LOCODE. From UN/LOCODE database (11,829 ports).","parameters":{"query":{"type":"string","description":"Port name, country name, or UN/LOCODE (e.g. 'Singapore', 'NL', 'US-LAX')"},"limit":{"type":"integer","description":"Max results","default":20}},"required":["query"],"output_example":{"results":[{"country":"SG","locode":"SG-SIN","name":"Singapore","lat":1.2833,"lon":103.85}],"total":1},"latency_class":"fast"},"tides":{"path":"/marine/tides","method":"GET","kind":"data","tier":"basic","description":"Tide predictions — sea level height with global coverage.","parameters":{"latitude":{"type":"number","description":"Latitude (-90 to 90)"},"longitude":{"type":"number","description":"Longitude (-180 to 180)"},"hours":{"type":"integer","description":"Hours of forecast","default":48}},"required":["latitude","longitude"],"output_example":{"location":{"lat":51.5,"lon":-0.12},"tide_data":[{"time":"2026-06-18T00:00","sea_level_height_m":1.25},{"time":"2026-06-18T01:00","sea_level_height_m":0.73}]},"latency_class":"fast"},"vessels":{"path":"/marine/vessels","method":"GET","kind":"data","tier":"basic","description":"Look up vessel types by AIS code or keyword. Based on IMO/ITU AIS ship type codes (20-89).","parameters":{"query":{"type":"string","description":"AIS code (20-89), ship type name, or keyword (e.g. 'tanker', 'passenger', 'fishing')"}},"required":["query"],"output_example":{"results":[{"code":80,"label":"Tanker","category":"tanker"}],"total":1},"latency_class":"fast"},"weather":{"path":"/marine/weather","method":"GET","kind":"data","tier":"basic","description":"Marine weather at a location — wave height/direction/period, swell, ocean currents, SST, and sea level.","parameters":{"latitude":{"type":"number","description":"Latitude (-90 to 90)"},"longitude":{"type":"number","description":"Longitude (-180 to 180)"}},"required":["latitude","longitude"],"output_example":{"location":{"lat":36.04,"lon":-5.04},"marine_weather":{"wave_height_m":0.78,"wave_direction_deg":83,"wave_period_s":6.4,"swell_wave_height_m":0.76,"swell_wave_period_s":5.15,"ocean_current_velocity_kmh":3.0,"ocean_current_direction_deg":104,"sea_surface_temp_c":20.7}},"latency_class":"fast"},"winds":{"path":"/marine/winds","method":"GET","kind":"data","tier":"basic","description":"Marine surface winds at a location — speed, direction, and gusts.","parameters":{"latitude":{"type":"number","description":"Latitude (-90 to 90)"},"longitude":{"type":"number","description":"Longitude (-180 to 180)"}},"required":["latitude","longitude"],"output_example":{"location":{"lat":36.04,"lon":-5.04},"marine_winds":{"wind_speed_10m_kmh":25.3,"wind_direction_10m_deg":225,"wind_gusts_10m_kmh":35.1}},"latency_class":"fast"},"ask":{"path":"/marine/ask","method":"POST","kind":"inference","tier":"regular","description":"Multi-source marine intelligence via DeepSeek — wave conditions, port info, vessel types, maritime safety.","parameters":{"question":{"type":"string","description":"Natural language question about marine conditions"},"latitude":{"type":"number","description":"Latitude for context"},"longitude":{"type":"number","description":"Longitude for context"},"port":{"type":"string","description":"Optional port name or LOCODE"}},"required":["question"],"output_example":{"question":"What are the wave conditions near Gibraltar?","answer":"Current wave height is 0.78m from 83° with swell 0.76m...","sources":["Marine Data","Port Database"]},"latency_class":"medium"}}