{"uid":"cap_9bxnE3wBhGK9J_6frS3R5","slug":"invoket-climate-return-period-api-71b20f80","name":"Invoket Climate Return Period API","description":"The checks your agent runs before it acts: verify a bank account, a phone number, a law in force, the weather or a vehicle — computed from official sources, with provenance in every response. You only pay for answers.","url":"https://api.invoket.com/climate/return-period?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["lat","lon","year","month"],"properties":{"lat":{"type":"string","description":"Latitude in decimal degrees. Alternative: pass city=<name> (alias location=, optional country= ISO 3166 alpha-2) instead of lat+lon — resolved via the embedded GeoNames gazetteer (exact match, most populous wins) and echoed back as data.location"},"lon":{"type":"string"},"year":{"type":"string"},"month":{"type":"string"}}},"responseSchema":{"type":"object"},"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_Q6IIzD2ShWv7wwguQtiuY","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Ranks a season's temperature or rainfall against a location's ERA5 historical climate distribution, returning percentile, empirical return period, and sample size for risk and climate finance applications.","exampleAgentPrompt":"For Paris (lat 48.85, lon 2.35), what percentile and return period was the 2022 summer mean temperature compared to ERA5 historical climate — and how many years of data is the estimate based on?","exampleUseCases":null,"resultDescription":"Returns the target year's seasonal climate value ranked within the ERA5 historical distribution for the location: a percentile (0–100), an empirical return period in years, and the sample size (number of historical seasons used). Useful for parametric insurance triggers, climate risk reports, and finance applications.","failureModes":["Invalid or out-of-range coordinates return an error (e.g. lat/lon outside ERA5 coverage)","Unsupported season or variable type returns a validation error","Target year outside ERA5 historical range returns no data","Payment not settled via x402 results in 402 Payment Required response","Missing required query parameters return a 400 Bad Request"],"whenToPreferThis":"Use this endpoint when you need to quantify how extreme a specific year's season was relative to long-term ERA5 climate history at a location — particularly for parametric insurance triggers, reinsurance pricing, climate risk disclosure, or climate finance. Prefer this over anomaly endpoints when you need return-period framing (e.g. '1-in-20-year event') rather than just deviation from mean. No account or API key needed; pay per call via stablecoin.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T00:31:41.868Z","isFirstParty":false,"canonicalSlug":"invoket-climate-return-period-api-71b20f80"}