DataActive

Weather Data

Real-time weather + 3-day forecast. Returns current (temp_c, feels_like_c, humidity_pct, wind_kph, weather_code) and forecast_3d array. Pass location as city name ('Berlin') or GPS string ('52.52,13.41'). WMO codes: 0=clear, 1-3=cloudy, 45-48=fog, 51-67=rain, 71-77=snow, 95-99=thunderstorm.

Endpointx402 Payment Required

POST

https://agentsvc.io/api/v1/proxy/weather

Price

$0.002 USDC

Latency P99

~400ms

Provider

agentsvc.io

Input Schema

{ "type": "object", "required": [ "location" ], "properties": { "location": { "type": "string", "description": "City name (e.g. 'Berlin'), or lat,lon string (e.g. '52.52,13.41'). Default: Berlin", "default": "Berlin" } } }

Output Schema

{ "type": "object", "required": [ "location", "current", "forecast_3d" ], "properties": { "location": { "type": "object", "required": [ "name", "lat", "lon" ], "properties": { "name": { "type": "string", "description": "Location name as provided in input" }, "lat": { "type": "number", "description": "Resolved latitude" }, "lon": { "type": "number", "description": "Resolved longitude" } } }, "current": { "type": "object", "required": [ "temp_c", "feels_like_c", "humidity_pct", "wind_kph", "weather_code" ], "properties": { "temp_c": { "type": "number", "description": "Current temperature in Celsius" }, "feels_like_c": { "type": "number", "description": "Apparent temperature in Celsius" }, "humidity_pct": { "type": "integer", "description": "Relative humidity percentage (0-100)" }, "wind_kph": { "type": "number", "description": "Wind speed in km/h" }, "weather_code": { "type": "integer", "description": "WMO weather code (0=clear, 1-3=cloudy, 45-48=fog, 51-67=rain, 71-77=snow, 80-82=showers, 95-99=thunderstorm)" } } }, "forecast_3d": { "type": "array", "description": "3-day daily forecast", "items": { "type": "object", "required": [ "date", "temp_max_c", "temp_min_c", "weather_code" ], "properties": { "date": { "type": "string", "format": "date", "description": "ISO 8601 date (YYYY-MM-DD)" }, "temp_max_c": { "type": "number", "description": "Maximum temperature in Celsius for this day" }, "temp_min_c": { "type": "number", "description": "Minimum temperature in Celsius for this day" }, "weather_code": { "type": "integer", "description": "WMO weather code — same scale as current.weather_code" } } } } }, "example": { "location": { "name": "Berlin", "lat": 52.52, "lon": 13.41 }, "current": { "temp_c": 12.5, "feels_like_c": 10.2, "humidity_pct": 71, "wind_kph": 14.8, "weather_code": 3 }, "forecast_3d": [ { "date": "2026-04-07", "temp_max_c": 14, "temp_min_c": 8.2, "weather_code": 1 }, { "date": "2026-04-08", "temp_max_c": 16.5, "temp_min_c": 9, "weather_code": 2 }, { "date": "2026-04-09", "temp_max_c": 13, "temp_min_c": 7.8, "weather_code": 61 } ] } }

Code Examples

# Step 1: Call without payment → receive 402 with requirements
curl -X POST "https://agentsvc.io/api/v1/proxy/weather" \
  -H "Content-Type: application/json" \
  -d '{
  "location": "Berlin"
}'

# Step 2: Sign payment using x402 SDK, then retry
curl -X POST "https://agentsvc.io/api/v1/proxy/weather" \
  -H "Content-Type: application/json" \
  -H "X-Payment: x402 usdc base <your-signed-payment>" \
  -d '{
  "location": "Berlin"
}'

Tags

#weather#geolocation#forecast#climate#realtime

Service Info

Service IDsvc_weather_02
Categorydata
StatusActive
ChainBase (USDC)
Protocolx402
Read API Documentation →