{"uid":"cap_e7cNe-tiEdaTJsm1qnLb7","slug":"worlddata402-sun-position-times-e524db6c","name":"WorldData402 Sun Position & Times","description":"Global market, government and reference data for AI agents. Pay-per-call over x402 (USDC on Base mainnet).","url":"https://worlddata402.worlddata402.workers.dev/v1/sun?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["lat","lon"],"properties":{"lat":{"type":"number"},"lon":{"type":"number"},"date":{"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_NoNnkjDzdqfxUV5OHJEYk","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":"Returns sunrise, sunset, solar noon, and sun position data for a given latitude/longitude and optional date.","exampleAgentPrompt":"What time does the sun rise and set tomorrow at latitude 48.8566, longitude 2.3522 — I need the exact solar schedule for Paris.","exampleUseCases":[{"title":"Golden hour timing for photography","prompt":"I'm doing a landscape photo shoot at latitude 36.1069, longitude -112.1129 on June 21st — can you tell me when golden hour and sunrise happen so I can plan my arrival?"},{"title":"Outdoor event daylight planning","prompt":"We're hosting an outdoor wedding at lat 34.0522, lon -118.2437 on September 14th — what time does the sun set so we know when to start setting up the lights?"},{"title":"Solar schedule for a remote work trip","prompt":"I'll be working remotely from Reykjavik, Iceland — coordinates 64.1355, -21.8954 — on December 22nd. How many hours of daylight will I actually get that day?"}],"resultDescription":"Returns computed solar event times (sunrise, sunset, solar noon, civil/nautical/astronomical twilight) and sun position metrics (altitude, azimuth) for the specified coordinates and date, expressed in UTC and/or local time depending on the response format.","failureModes":["Missing required lat or lon parameters returns a 400/422 error","Coordinates out of valid range (lat > 90, lon > 180) may return an error or unexpected results","Invalid date format may cause a parsing error","Payment failure over x402 returns 402 Payment Required","Polar regions may return null for sunrise/sunset during midnight sun or polar night periods"],"whenToPreferThis":"Choose this endpoint when you need precise, pay-per-call solar event calculations (sunrise, sunset, solar noon, twilight) for any global coordinate without requiring a subscription. Ideal for agents that need occasional sun timing lookups billed micropayment-style via USDC on Base, without managing API keys or monthly plans.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:41:24.737Z","isFirstParty":false,"canonicalSlug":"worlddata402-sun-position-times-e524db6c"}