{"uid":"cap_uSoCqhIbK4OxcodMWDI_c","slug":"locus-air-quality-history-0e32315b","name":"Locus Air Quality History","description":"Historical location-specific air-quality evidence: nearby EPA AQS annual monitor summaries, exact-point NOAA HMS satellite smoke days, and clearly separated CDC county-level modeled PM2.5 only where a requested year lacks nearby AQS PM2.5. This is not wildfire hazard, source-fire attribution, medical advice, or a safe/unsafe property score. Missing mirror years are disclosed and never treated as clean air. npx @velinussage/locus-agent-skill add.","url":"https://api.locus.report/api/locus-air-quality-history","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"address":{"type":"string","maxLength":200,"minLength":5},"latitude":{"type":"number","maximum":90,"minimum":-90},"radiusKm":{"type":"integer","maximum":150,"minimum":5},"longitude":{"type":"number","maximum":180,"minimum":-180},"yearsBack":{"type":"integer","maximum":10,"minimum":1}}},"responseSchema":{"type":"json","example":{"id":"locus_example","caveats":["Example artifact; not live data."],"records":[],"generatedAt":"2026-01-01T00:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mCLH2su-MkIgmtuDcEqdz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves historical air quality records for a geographic area around a property address or coordinates over a specified number of years.","exampleAgentPrompt":"Pull the air quality history for 742 Evergreen Terrace, Springfield within a 20km radius going back 5 years — I want to know if there are any environmental risk signals before we make an offer on the property.","exampleUseCases":[{"title":"Pre-purchase environmental due diligence","prompt":"Before I put in an offer on 1400 Oak Street, can you check the air quality history within 15km going back 7 years? I want to know if there have been any pollution issues that could affect the property's value or habitability."},{"title":"Commercial site environmental risk scan","prompt":"We're evaluating a warehouse site at latitude 41.8781 longitude -87.6298 — can you pull the air quality records for a 30km radius over the past 10 years so we can assess any environmental liability?"},{"title":"Neighborhood air quality trend research","prompt":"I'm writing a report on environmental trends in the Denver metro area. Can you get the air quality history for 80202 within 50km going back 5 years so I can see how pollution levels have changed?"}],"resultDescription":"Returns a JSON object containing a unique scan ID, a list of historical air quality records for the specified area and time range, a timestamp indicating when the report was generated, and any relevant caveats or data limitations about the records returned.","failureModes":["Address not found or too vague — returns empty records with caveats","Radius or yearsBack out of allowed range — validation error","No historical data available for the specified region — empty records array","Invalid coordinates (out of bounds) — request rejected","Payment failure via x402 protocol — 402 response before data is returned"],"whenToPreferThis":"Use this endpoint when you need historical air quality data tied to a specific property address or geographic coordinate, particularly for real estate due diligence, environmental risk assessment, or property valuation analysis. Prefer this over general weather or AQI APIs when the use case is property-centric and requires multi-year historical records with local parcel context from Locus.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:54:53.920Z","isFirstParty":false}