{"uid":"cap_0cCRvwYlN9AAmxAlqEd-_","slug":"call402-com-weather-api-x402-7795d80c","name":"call402.com Weather API (x402)","description":"USDC pay-per-call APIs for AI agents via the x402 protocol (v2, exact, Base mainnet). Send a request, receive HTTP 402 with payment requirements, pay with @x402/fetch or any x402 client, retry with the PAYMENT-SIGNATURE header.","url":"https://call402.com/api/weather?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"city":{"type":"string","description":"City name (or provide latitude/longitude instead)"},"days":{"type":"integer","description":"Forecast days, 1-7 (default 3)"},"latitude":{"type":"number"},"longitude":{"type":"number"}}},"responseSchema":{"type":"json","example":{"meta":{"source":"open-meteo"},"daily":[{"date":"2026-10-19","condition":"partly cloudy","temp_max_c":25,"temp_min_c":18.2,"weather_code":2,"precipitation_probability_max_pct":10}],"current":{"time":"2026-10-19T10:00","wind_kmh":12.4,"condition":"partly cloudy","humidity_pct":60,"weather_code":2,"temperature_c":22.5,"apparent_temperature_c":23.1},"location":{"name":"Shanghai","region":"Shanghai","country":"China","latitude":31.23,"timezone":"Asia/Shanghai","longitude":121.47}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gX-7soLEXNcdCm7d6jTQx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current conditions and a multi-day forecast for a given city or coordinates, paid per-call with USDC via the x402 protocol on Base mainnet.","exampleAgentPrompt":"What's the weather like in Barcelona right now, and can you give me a 5-day forecast so I know what to expect?","exampleUseCases":[{"title":"Travel packing decision support","prompt":"I'm heading to Tokyo on Thursday — can you pull the current weather and a 5-day forecast so I know what conditions to expect while I'm there?"},{"title":"Outdoor event weather check","prompt":"We have an outdoor concert in Austin, Texas this Saturday. Can you check the weather forecast for the next 3 days and tell me the chance of rain and temperature range?"},{"title":"Real-time logistics routing alert","prompt":"Our delivery drivers are heading to Miami today. Can you get me the current wind speed, temperature, and any precipitation probability for Miami right now?"}],"resultDescription":"A JSON object with three sections: 'current' (temperature, apparent temperature, humidity, wind speed, weather condition string, weather code), 'daily' (array of up to 7 days each with date, condition, temp_max_c, temp_min_c, weather_code, precipitation_probability_max_pct), and 'location' (resolved city name, region, country, latitude, longitude, timezone). A 'meta' field indicates the data source (Open-Meteo).","failureModes":["City name not recognized — returns error or empty location; use lat/lon instead","Days parameter outside 1–7 range may be rejected or clamped","Neither city nor lat/lon provided — likely 400 Bad Request","HTTP 402 returned on first call if x402 payment header not yet sent — expected behavior; retry with PAYMENT-SIGNATURE header","Network or upstream Open-Meteo outage — 5xx error propagated","Ambiguous city name (e.g. 'Springfield') may resolve to an unintended location"],"whenToPreferThis":"Choose this endpoint when your agent needs real-time weather data or short-range forecasts (1–7 days) and operates in a crypto-native / x402 micropayment context. At $0.005 USDC per call it is cost-effective for per-request agent workflows on Base mainnet. Prefer it over subscription-based weather APIs when you want pay-as-you-go pricing without API key management. The Open-Meteo backend provides global coverage with no additional licensing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:35:18.559Z","isFirstParty":false,"canonicalSlug":"call402-com-weather-api-x402-7795d80c"}