{"id":"finance/planetary-lines","method":"POST","url":"https://astro-agent.dev/v1/finance/planetary-lines","price_usd":"0.20","tier":"premium","title":"Gann planetary lines","summary":"Planet degrees (geocentric and heliocentric) at a moment or as a time series, with aspect offsets, Mean of 5 / Circle of 8 and price levels.","description":"Financial-astrology DATA for charting and backtests, not signals: the longitude of each planet, seen from the Earth and from the Sun in one call, plus the aspect offsets you ask for (+/-90, 120...), the Optuma averages Mean of 5 and Circle of 8, speeds, retrograde flags and declinations. Snapshot ('datetime') or series ('start', 'end', 'interval' 1h..1w, up to 1000 samples, optionally unwrapped for plotting) in columns ready for pandas. With 'price_unit' and 'price_range': every price level (degree + 360 k) x unit. Each result is hashed, so a backtest can cite and replay it.","input_schema":{"type":"object","properties":{"datetime":{"type":"string","description":"A moment (snapshot): ISO 8601 with Z or an offset, e.g. '2024-01-01T00:00Z'. A local time needs 'timezone' or coordinates. Omit when giving start/end."},"timezone":{"type":"string","description":"IANA zone, e.g. 'Asia/Kolkata'. Optional: resolved from the coordinates, with the historical offset (DST, Local Mean Time) of that date."},"start":{"type":"string","description":"Series: first UTC date, YYYY-MM-DD. Example: '2024-01-01'."},"end":{"type":"string","description":"Series: last UTC date, YYYY-MM-DD (at most 1000 samples)."},"interval":{"type":"string","enum":["1h","4h","12h","1d","1w"],"default":"1d","description":"Series sampling step, in candle-timeframe notation."},"time_utc":{"type":"string","default":"00:00","description":"Series: UTC time of day of the first sample, HH:MM."},"perspective":{"type":"string","enum":["geocentric","heliocentric","both"],"default":"both","description":"Geocentric, heliocentric, or both in one call (default)."},"bodies":{"type":"array","items":{"type":"string","enum":["sun","moon","mercury","venus","earth","mars","jupiter","saturn","uranus","neptune","pluto","mean_node","true_node"]},"description":"Bodies to draw. Default: Sun..Pluto (geo), Mercury..Pluto with Earth (helio)."},"aspects":{"description":"Aspect offsets added to every line (+angle and -angle). Default: the planet's own line only (conjunction).","oneOf":[{"type":"string","enum":["all"]},{"type":"array","items":{"type":"string","enum":["conjunction","opposition","trine","square","sextile","quincunx","semisextile","semisquare","sesquiquadrate","quintile","biquintile"]}}]},"averages":{"type":"array","items":{"type":"string","enum":["mean_of_5","circle_of_8"]},"description":"Optuma averages: mean_of_5 = (Jupiter+Saturn+Uranus+Neptune+Pluto)/5, circle_of_8 = (Mercury..Pluto)/8, in each perspective."},"average_method":{"type":"string","enum":["arithmetic","circular"],"default":"arithmetic","description":"'arithmetic' mean of the 0-360 longitudes (Optuma's rule) or 'circular' (vector) mean."},"price_unit":{"type":"number","exclusiveMinimum":0,"description":"Price per degree. With price_range: levels = (degree + 360 k) x price_unit."},"price_range":{"type":"object","properties":{"min":{"type":"number","minimum":0,"description":"Lowest price to list."},"max":{"type":"number","description":"Highest price to list."}},"description":"The price window in which to list levels, e.g. {min: 30000, max: 80000}."},"unwrap":{"type":"boolean","default":false,"description":"Series: continuous degrees (no 360 -> 0 jump), for plotting lines across a chart."},"include_declination":{"type":"boolean","default":false,"description":"Series: also a declination column per body."},"format":{"type":"string","enum":["columns","rows"],"default":"columns","description":"Series layout: 'columns' (pandas.DataFrame(result['series'])) or 'rows' (one object per sample)."},"options":{"type":"object","description":"Optional zodiac settings.","properties":{"zodiac":{"type":"string","enum":["tropical","sidereal"],"default":"tropical","description":"'tropical' (default) or 'sidereal' (pair it with 'ayanamsa')."},"ayanamsa":{"type":"string","enum":["fagan_bradley","krishnamurti","lahiri","raman","true_chitrapaksha","yukteshwar"],"default":"lahiri","description":"Only with zodiac=sidereal."}}}}},"example_request":{"datetime":"2024-01-01T00:00Z","aspects":["square","opposition"],"averages":["mean_of_5"],"price_unit":1000,"price_range":{"min":30000,"max":80000}},"example_response":{"endpoint":"finance/planetary-lines","result":{"subject":{"time":{"local_input":"2024-01-01T00:00Z","time_basis":"civil","timezone":null,"timezone_source":"offset_in_datetime","utc_offset":"+00:00","is_dst":null,"utc":"2024-01-01T00:00:00Z","julian_day_ut":2460310.5,"julian_day_tt":2460310.500801,"delta_t_seconds":69.175,"time_known":true}},"settings":{"perspectives":["geocentric","heliocentric"],"zodiac":"tropical","bodies":{"geocentric":["sun","mercury","venus"],"heliocentric":["mercury","venus","earth"]},"aspects":["square","opposition"],"line_offsets_deg":[0.0,90.0,180.0],"averages":{"mean_of_5":["jupiter","saturn","uranus"]},"average_method":"arithmetic","frames":{"geocentric":"geocentric apparent, true ecliptic and equinox of date","heliocentric":"heliocentric geometric positions (Sun -> body, no light-time), true ecliptic and equinox of date"},"line_id":"<geo|helio>.<body or average>[+<offset deg>]; degree = (longitude + offset) mod 360","price_formula":"price = (degree + 360 k) x price_unit, for every integer k in price_range","price_unit":1000.0,"price_range":{"min":30000.0,"max":80000.0}},"lines":[{"id":"geo.sun","perspective":"geocentric","base":"sun","offset_deg":0.0,"degree":280.038994,"position":"10°02'20\" Capricorn","speed_deg_per_day":1.018948,"retrograde":false,"declination":-23.058467,"price_levels":[]},{"id":"geo.sun+90","perspective":"geocentric","base":"sun","offset_deg":90.0,"degree":10.038994,"position":"10°02'20\" Aries","price_levels":[]},{"id":"geo.sun+180","perspective":"geocentric","base":"sun","offset_deg":180.0,"degree":100.038994,"position":"10°02'20\" Cancer","price_levels":[]}],"counts":{"lines":80,"price_levels":11},"price_levels":[{"price":34528.739815,"line":"geo.mean_of_5+180"},{"price":35582.39315,"line":"geo.jupiter"},{"price":38425.542754,"line":"helio.mean_of_5+180"}]},"meta":{"engine":"astro-agents/1.8.0","ephemeris":"NASA/JPL DE440 (1800-01-01..2200-01-01)","astronomy_library":"skyfield/1.55","frame":"geocentric apparent positions, true ecliptic and equinox of date (IAU 2006/2000A)","deterministic":true,"llm_used":false,"input_sha256":"7e9779b8185bff3d98037ca2ba8dd203aa88cb025a3f794c766f8d7887d87695","result_sha256":"b2c0df24d8f2534aba354875a0ae36acaa112b0d91f6530dd3529b9582ba9099","reproducibility":"result_sha256 = SHA-256 of the result serialized as JSON with sorted keys, no whitespace, UTF-8, floats rounded to 6 decimals. Same input + same engine version => same hash."},"example_note":"real output of engine 1.8.0; lists shortened to 3 items"},"payment":"x402 or MPP; always paid. POST without payment to receive the 402 challenge.","catalog":"https://astro-agent.dev/v1/catalog"}