{"uid":"cap_4qqQ4feaFmupUJ2LmpUk-","slug":"aviationapis-metar-5fbaf25c","name":"AviationAPIs METAR","description":"Pay-per-call aviation data APIs for AI agents, settled in USDC via the x402 protocol.","url":"https://aviationapis.com/metar","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"icao":{"type":"string","pattern":"^[A-Za-z]{4}$","description":"4-letter ICAO airport code (e.g. 'KSFO', 'EGLL', 'RJTT')"}}},"responseSchema":{"type":"json","example":{"raw":"KSFO 021856Z 28014KT 10SM FEW016 19/13 A3004","icao":"KSFO","name":"San Francisco Intl","wind":{"gust_kt":null,"speed_kt":14,"direction_deg":280},"clouds":[{"cover":"FEW","base_ft":1600}],"temp_c":19,"weather":null,"dewpoint_c":13,"fetched_at":"2026-06-02T18:58:11.000Z","observed_at":"2026-06-02T18:56:00Z","altimeter_hpa":1017,"visibility_sm":10,"flight_category":"VFR"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9KtHRM7sdIiP5uSkztUZw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the latest METAR (aviation weather observation) for a given airport by ICAO code, including wind, visibility, clouds, temperature, altimeter, and flight category.","exampleAgentPrompt":"What are the current flight conditions at San Francisco International — specifically the wind, visibility, cloud ceiling, and whether it's VFR or IFR right now? The ICAO code is KSFO.","exampleUseCases":[{"title":"Pre-flight weather briefing check","prompt":"Before I file my flight plan from Chicago O'Hare to Denver International, can you pull the current METAR for KORD and KDEN? I need to know the winds, visibility, cloud ceiling, and whether either airport is IFR right now."},{"title":"Live dispatch conditions for airline ops","prompt":"We have a flight inbound to Tokyo Narita — ICAO code RJAA. What are the current conditions on the ground there? I need wind speed and direction, visibility, flight category, and the altimeter setting for the crew."},{"title":"Check VFR viability at local airfield","prompt":"I'm thinking about taking the Cessna out this afternoon. Can you check the latest weather observation at KPAO — Palo Alto Airport — and tell me if it's VFR, what the winds are doing, and whether there's any low cloud ceiling I should worry about?"}],"resultDescription":"Returns a JSON object containing the raw METAR string, decoded fields including wind speed/direction/gust in knots, visibility in statute miles, cloud layers with coverage and base altitude in feet, temperature and dewpoint in Celsius, altimeter in hPa, flight category (e.g. VFR, MVFR, IFR, LIFR), and timestamps for when the observation was made and fetched.","failureModes":["Invalid or non-existent ICAO code returns an error response","Station has no recent METAR report (remote or inactive airport)","Payment failure via x402 protocol prevents data retrieval","Network timeout if the upstream METAR data source is unavailable","Malformed request body (e.g. ICAO code not exactly 4 letters) returns validation error"],"whenToPreferThis":"Use this endpoint when you need real-time, decoded aviation weather observations (METAR) for a specific airport identified by its ICAO code. Prefer this over TAF endpoints when you need current conditions rather than forecasts, and over general weather APIs when you need aviation-specific data like flight category, altimeter setting, and cloud coverage in aviation standard units. Best for pilot briefing tools, flight planning assistants, dispatch systems, or any agent that needs to answer 'what are conditions like right now at airport X?'","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T04:06:39.300Z","isFirstParty":false}