{"uid":"cap_00qQ_cwvsxLqPKGKh8EUx","slug":"fieldpulse-planting-window-optimizer-98b2fa94","name":"FieldPulse Planting Window Optimizer","description":"Planting window optimizer for grower and farmer agents. Returns optimal planting dates from live soil temperature, frost dates, crop calendar, and growing-degree-day requirements for any crop and location.","url":"https://fieldpulse-tan.vercel.app/api/planting-window","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"lat":{"type":"string"},"lon":{"type":"string"},"crop":{"type":"string"},"lang":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"errors":{"type":"object","description":"Documented error responses, keyed by HTTP status code","additionalProperties":{"type":"object","required":["description"],"properties":{"example":{"type":"object"},"description":{"type":"string"}}}},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"crop":"potatoes","frost_risk":{"first_autumn_frost":"2026-10-25","last_frost_estimate":"2026-04-08","frost_free_days_remaining":198},"hemisphere":"northern","soil_readiness":{"ready":true,"temperature_c":12.4,"moisture_status":"optimal","germination_threshold_c":10},"planting_recommendation":{"status":"optimal_now","optimal_window_end":"2026-05-10","recommended_action":"Plant now — soil temperature and moisture are optimal","optimal_window_start":"2026-04-15"}}},"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_unFY9dLT7KIJzKKzdaRf5","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":"Returns optimal planting dates for any crop and location by synthesizing live soil temperature, frost dates, crop calendars, and growing-degree-day requirements.","exampleAgentPrompt":"What's the optimal planting window for corn near Ames, Iowa this season — factor in current soil temperatures, frost dates, and growing-degree-day requirements so I know when to get seeds in the ground.","exampleUseCases":null,"resultDescription":"Returns optimal planting dates and the full planting window for the requested crop and location, incorporating live soil temperature readings at multiple depths, last/first frost date estimates, crop-specific growing-degree-day requirements, and a crop calendar reference — giving growers a data-backed recommendation on when to plant.","failureModes":["Unsupported crop variety returns an error or null planting data","Location outside supported geographic coverage returns no soil or frost data","Soil temperature data temporarily unavailable due to sensor or upstream feed outage","Missing required parameters (crop or location) returns a 400-level error","Payment not processed or x402 auth failure results in 402 response blocking the call"],"whenToPreferThis":"Choose this endpoint when you need a science-backed, data-driven planting date recommendation that integrates live soil temperature, frost risk, and crop-specific growing-degree-day thresholds — rather than a generic static crop calendar. Ideal for grower and farmer agents making seasonal planting decisions that require real-time agronomic data fusion.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:33:16.806Z","isFirstParty":false}