{"openapi":"3.1.0","info":{"title":"Marine Buoys API","version":"1.0.0","description":"Live marine weather and ocean conditions from NOAA's National Data Buoy Center (NDBC). The station catalogue (1,930 moored buoys and coastal stations worldwide) is searchable by name, type or coordinate; the live endpoint returns the latest observation for any station: significant wave height, wave period and direction, water and air temperature, wind speed/gust/direction, atmospheric pressure and more. Find the nearest buoys to any lat/lon. Ideal for surfing & sailing apps, marine operations, coastal monitoring and oceanography.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/buoys-api","description":"oanor gateway"}],"tags":[{"name":"Marine Buoys"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/buoy":{"get":{"operationId":"get_v1_buoy","tags":["Marine Buoys"],"summary":"Latest live observation for a station","description":"","parameters":[{"name":"station","in":"query","required":true,"description":"NDBC station id, e.g. 41001","schema":{"type":"string"},"example":"41001"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"name":"EAST HATTERAS - 150 NM East of Cape Hatteras","wind":{"gust_m_s":12,"speed_m_s":10,"direction_deg":10},"waves":[],"source":"NOAA NDBC","station":"41001","latitude":34.791,"longitude":-72.42,"air_temp_c":18.3,"dewpoint_c":11.6,"observed_at":"2026-05-31T05:10:00Z","pressure_hpa":1015.4,"water_temp_c":23.1},"meta":{"timestamp":"2026-05-31T05:47:59.997Z","request_id":"cee9a3a5-63a8-41fc-9621-0309f99c6b3e"},"status":"ok","message":"Buoy observation retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/nearby":{"get":{"operationId":"get_v1_nearby","tags":["Marine Buoys"],"summary":"Stations within a radius of a coordinate","description":"","parameters":[{"name":"lat","in":"query","required":false,"description":"Latitude (-90..90)","schema":{"type":"string"},"example":"25.8"},{"name":"lon","in":"query","required":false,"description":"Longitude (-180..180)","schema":{"type":"string"},"example":"-80.1"},{"name":"radius_km","in":"query","required":false,"description":"Search radius in km (1-20000, default 200)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1-100, default 10)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"total":63,"center":{"lat":25.8,"lon":-80.1},"results":[{"id":"VAKF1","name":"8723214 - Virginia Key, FL","type":"Water Level Observation Network","owner":"O","latitude":25.731,"longitude":-80.162,"distance_km":9.9},{"id":"41122","name":"Hollywood Beach, FL (265)","type":"Waverider Buoy","owner":"R","latitude":26.001,"longitude":-80.096,"distance_km":22.4},{"id":"FWYF1","name":"Fowey Rock, FL","type":"C-MAN Station","owner":"N","latitude":25.591,"longitude":-80.097,"distance_km":23.2},{"id":"BBNF1","name":"BBCW8","type":"C-MAN Station","owner":"NP","latitude":25.601,"longitude":-80.306,"distance_km":30.3},{"id":"PEGF1","name":"8722956 - Port Everglades, FL","type":"Water Level Observation Network","owner":"PT","latitude":26.086,"longitude":-80.116,"distance_km":31.8},{"id":"PVGF1","name":"Port Everglades Channel, FL","type":"Fixed Structure Weather Station","owner":"IC","latitude":26.092,"longitude":-80.109,"distance_km":32.5},{"id":"BBSF1","name":"BBCW10","type":"C-MAN Station","owner":"NP","latitude":25.472,"longitude":-80.349,"distance_km":44.2},{"id":"MDKF1","name":"Middle Key, FL","type":"Water Quality Station","owner":"NP","latitude":25.289,"longitude":-80.396,"distance_km":64.1},{"id":"HCEF1","name":"Highway Creek, FL","type":"Water Quality Station","owner":"NP","latitude":25.254,"longitude":-80.444,"distance_km":69.8},{"id":"MNBF1","name":"Manatee Bay, FL","type":"Water Quality Station","owner":"NP","latitude":25.239,"longitude":-80.422,"distance_km":70.3}],"radius_km":200},"meta":{"timestamp":"2026-05-31T05:48:00.067Z","request_id":"59c9191c-7e4c-491e-a3fb-427fbec58c9d"},"status":"ok","message":"Nearby stations listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Marine Buoys"],"summary":"Search the station catalogue","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Name / id search, e.g. hatteras","schema":{"type":"string"},"example":"hatteras"},{"name":"type","in":"query","required":false,"description":"Station type substring, e.g. buoy","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results per page (1-100, default 20)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":6,"limit":20,"query":"hatteras","total":6,"offset":0,"results":[{"id":"41001","name":"EAST HATTERAS - 150 NM East of Cape Hatteras","type":"3-meter foam buoy","owner":"N","latitude":34.791,"longitude":-72.42},{"id":"41002","name":"SOUTH HATTERAS - 225 NM South of Cape Hatteras","type":"3-meter foam buoy","owner":"N","latitude":31.743,"longitude":-74.955},{"id":"41062","name":"Hatteras Bay (B1)","type":"Buoy","owner":"UB","latitude":35.778,"longitude":-75.095},{"id":"41120","name":"Cape Hatteras East, NC (250)","type":"Waverider Buoy","owner":"R","latitude":35.258,"longitude":-75.285},{"id":"41X01","name":"Adrift from 41001, 150nm E of Cape Hatteras","type":"3-meter foam buoy","owner":"N","latitude":34.502,"longitude":-72.522},{"id":"HCGN7","name":"8654467 - USCG Station Hatteras, NC","type":"Water Level Observation Network","owner":"O","latitude":35.209,"longitude":-75.704}]},"meta":{"timestamp":"2026-05-31T05:48:00.142Z","request_id":"bb556165-b174-40d9-afc5-4504741160ae"},"status":"ok","message":"Stations listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Totals & source","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Station catalogue is bundled; /v1/buoy fetches the latest live observation from NDBC. Units: m/s wind, metres wave height, °C, hPa.","fields":["station","name","observed_at","wind","waves","pressure_hpa","air_temp_c","water_temp_c","visibility_nmi"],"source":"NOAA National Data Buoy Center (NDBC)","stations":1930,"endpoints":["/v1/buoy","/v1/search","/v1/nearby","/v1/meta"]},"meta":{"timestamp":"2026-05-31T05:48:00.222Z","request_id":"25b4998b-5f23-4241-bb3a-2975b4e541ea"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":650,"monthly_call_quota":45000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1900,"monthly_call_quota":240000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4900,"monthly_call_quota":1200000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/buoys-api"}