{"uid":"cap_aItxoBhjk6dL_8I6VKpsF","slug":"kalshi-weather-market-data-scraper-29e128f8","name":"Kalshi Weather Market Data Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/kalshi?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"mode":{"enum":["live","settled","both"],"type":"string","default":"live","description":"Live contracts, finalized contracts with results, or both. Settled mode includes archived markets within the date window."},"cities":{"type":"array","default":["NYC"],"description":"City names or codes such as NYC, Chicago, Miami, or all. Temperature markets cover 24 cities; daily rain also covers several more."},"dateTo":{"type":"string","description":"Optional last market date, inclusive. Use YYYY-MM-DD, YYYYMMDD, today, tomorrow or yesterday."},"dateFrom":{"type":"string","description":"Optional first market date, inclusive. Use YYYY-MM-DD, YYYYMMDD, today, tomorrow or yesterday."},"maxItems":{"type":"integer","default":100,"minimum":0,"description":"Stop after this many market records. Zero means no item cap; the run charge limit still applies."},"seriesType":{"enum":["both","KXHIGH","KXLOW","KXRAIN","KXRAINM","rain","all"],"type":"string","default":"both","description":"Choose daily high, daily low, daily rain, monthly rain, both temperature series, both rain series, or all four families."},"lookbackDays":{"type":"integer","default":30,"maximum":365,"minimum":1,"description":"How many market dates to include in settled mode when dateFrom is empty. The archive is included when needed."},"includeTrades":{"type":"boolean","default":false,"description":"Add up to 1,000 recent trades per market. Adds one request per market and can take longer."},"includeOrderbook":{"type":"boolean","default":false,"description":"Add bid levels for active markets. Adds one request per active market; settled markets have empty books."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"city":null,"ticker":null,"station_id":null,"series_type":null,"strike_type":null,"event_ticker":null,"bracket_label":null,"series_ticker":null}],"product":"kalshi"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5kv_u2gqNBtBUiOJwDUC8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches structured Kalshi weather prediction market data (temperature highs/lows and rainfall contracts) for specified cities and date ranges, including optional order book and trade history.","exampleAgentPrompt":"Pull both live and settled Kalshi weather markets for NYC and Chicago from January 1 to January 31, covering both temperature series (KXHIGH and KXLOW), and include the order book for active contracts — cap it at 200 records.","exampleUseCases":[{"title":"Live weather market monitoring for traders","prompt":"Get all live Kalshi temperature markets for NYC, Chicago, and Miami right now — both daily high and daily low series — with the current order book included so I can see bid levels."},{"title":"Backtesting settled rain markets","prompt":"Pull settled Kalshi rain markets (KXRAIN) for NYC and Miami for the past 90 days, including trade history for each market, so I can analyze how they resolved."},{"title":"Multi-city weather contract research","prompt":"Fetch both live and settled Kalshi weather markets across all available cities for the date range from March 1 to March 31, covering all four series types — KXHIGH, KXLOW, KXRAIN, and KXRAINM — and give me up to 500 records."}],"resultDescription":"Returns a JSON object with a count and an items array. Each item represents a Kalshi weather market contract with fields including city, ticker, station_id, series_type, strike_type, event_ticker, bracket_label, and series_ticker. If requested, each item may also include up to 1,000 recent trades and/or order book bid levels for active markets.","failureModes":["Invalid city code returns empty items array or error","Date format not matching YYYY-MM-DD or YYYYMMDD causes parsing failure","Unsupported seriesType enum value rejected","lookbackDays exceeding 365 rejected with validation error","includeTrades or includeOrderbook causing timeout for large market sets","Empty result set when no markets exist for the given parameters — not charged","Kalshi upstream API unavailability causing failed run — not charged"],"whenToPreferThis":"Use this endpoint when you need structured Kalshi weather prediction market data — temperature (daily high/low) or rainfall contracts — for specific cities and date ranges, with optional trade history and order book depth. Prefer this over direct Kalshi API calls when you need pay-per-use access without managing API credentials, or when you need both live and archived settled markets in one call. Best for weather market research, trading strategy backtesting, and real-time market monitoring across multiple cities.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:01.223Z","isFirstParty":false,"canonicalSlug":"kalshi-weather-market-data-scraper-29e128f8"}