{"id":"finance/token-chart","method":"POST","url":"https://astro-agent.dev/v1/finance/token-chart","price_usd":"0.25","tier":"premium","title":"Token launch sky (crypto token chart)","summary":"Launch sky of a token: planet positions, retrogrades and aspects at its launch moment, plus the key astronomical dates ahead (exact returns and aspects to those positions), with a shareable SVG card.","description":"Give a token's launch moment (the block time of its contract deployment or mint, UTC, to the second) and get the geocentric sky at that instant: each planet's sign, degree, longitude and retrograde flag, the major aspects between them, element and modality balance (no houses: a token has no place). Then the key dates: the exact UTC minute, over up to 366 days from 'from', at which each transiting planet returns to its launch position or aspects a launch position, each with a unix timestamp and a stable key, in rows ready for pandas. result.card.svg is a server-rendered 1200x675 card (wheel, positions, next key dates) ready to post. Key astronomical dates, data only — never a signal or forecast.","input_schema":{"type":"object","required":["launch_datetime"],"properties":{"launch_datetime":{"description":"The token's launch moment in UTC: ISO 8601 with Z or an offset, to the second ('2018-08-03T19:28:24Z'), or unix seconds (an on-chain block time). Use the block time of the contract deployment or of the mint, from an explorer.","oneOf":[{"type":"string"},{"type":"integer"}],"examples":["2018-08-03T19:28:24Z"]},"token":{"type":"object","properties":{"chain":{"type":"string","description":"Chain name, lowercase: 'ethereum', 'base', 'solana'..."},"address":{"type":"string","description":"Contract or mint address (shown on the card)."},"symbol":{"type":"string","description":"Ticker shown on the card, e.g. 'USDC'."},"name":{"type":"string","description":"Name shown on the card, e.g. 'USD Coin'."}},"description":"Optional label drawn on the card and echoed in the result. On-chain resolution of the launch time is not available yet: give launch_datetime."},"from":{"type":"string","description":"First UTC date of the key dates, YYYY-MM-DD. Default: today (UTC); pass it for a reproducible call. Example: '2026-11-01'."},"days":{"type":"integer","minimum":1,"maximum":366,"default":366,"description":"How many days of key dates from 'from'."},"transit_bodies":{"type":"array","items":{"type":"string","enum":["sun","mercury","venus","mars","jupiter","saturn","uranus","neptune","pluto"]},"description":"Transiting bodies timed against the launch positions (default all nine)."},"limit":{"type":"integer","minimum":1,"maximum":1000,"default":50,"description":"Maximum key dates returned (counts.key_dates gives the total)."},"card":{"type":"boolean","default":true,"description":"Include the shareable SVG card (result.card.svg)."},"options":{"type":"object","description":"Optional zodiac and aspect 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."},"aspects":{"description":"'all' or a list from ['conjunction', 'opposition', 'trine', 'square', 'sextile', 'quincunx', 'semisextile', 'semisquare', 'sesquiquadrate', 'quintile', 'biquintile'].","oneOf":[{"type":"string","enum":["all"]},{"type":"array","items":{"type":"string","enum":["conjunction","opposition","trine","square","sextile","quincunx","semisextile","semisquare","sesquiquadrate","quintile","biquintile"]}}]},"orbs":{"type":"object","additionalProperties":{"type":"number"},"description":"Orb overrides in degrees per aspect, e.g. {'conjunction': 6}."}}}}},"example_request":{"launch_datetime":"2018-08-03T19:28:24Z","from":"2026-11-01","days":90,"token":{"chain":"ethereum","address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","symbol":"USDC","name":"USD Coin"}},"example_response":{"endpoint":"finance/token-chart","result":{"subject":{"launch_utc":"2018-08-03T19:28:24Z","token":{"chain":"ethereum","address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","symbol":"USDC","name":"USD Coin"}},"settings":{"zodiac":"tropical","frame":"geocentric apparent, true ecliptic and equinox of date","houses":"none: a token has no place, so no houses, ascendant or MC","launch_source":"launch_datetime as given by the caller (not resolved on-chain)","aspects":{"types":["conjunction","opposition","trine"],"orbs":{"conjunction":8.0,"opposition":8.0,"trine":7.0,"square":7.0,"sextile":5.0},"luminary_orb_bonus":2.0},"key_dates":{"from":"2026-11-01","to":"2027-01-29","days":90,"transit_bodies":["sun","mercury","venus"],"launch_points":["sun","moon","mercury"],"aspects":["conjunction","opposition","trine"],"limit":50,"precision":"+/- 1 minute (UTC)","timestamp":"unix seconds of date_utc, to join on candle open times"}},"planets":{"sun":{"name":"Sun","glyph":"☉","sign":"Leo","degree":11,"minute":24,"deg":"11°24'","position":"11°24'24\" Leo","longitude":131.4066,"speed_longitude":0.957146,"retrograde":false,"element":"fire","modality":"fixed"},"moon":{"name":"Moon","glyph":"☽","sign":"Aries","degree":29,"minute":47,"deg":"29°47'","position":"29°47'50\" Aries","longitude":29.797106,"speed_longitude":12.997142,"retrograde":false,"element":"fire","modality":"cardinal"},"mercury":{"name":"Mercury","glyph":"☿","sign":"Leo","degree":20,"minute":26,"deg":"20°26'","position":"20°26'28\" Leo","longitude":140.441118,"speed_longitude":-0.661901,"retrograde":true,"element":"fire","modality":"fixed"},"venus":{"name":"Venus","glyph":"♀","sign":"Virgo","degree":26,"minute":44,"deg":"26°44'","position":"26°44'29\" Virgo","longitude":176.741281,"speed_longitude":1.036507,"retrograde":false,"element":"earth","modality":"mutable"},"mars":{"name":"Mars","glyph":"♂","sign":"Aquarius","degree":2,"minute":6,"deg":"2°06'","position":"2°06'10\" Aquarius","longitude":302.10268,"speed_longitude":-0.258296,"retrograde":true,"element":"air","modality":"fixed"},"jupiter":{"name":"Jupiter","glyph":"♃","sign":"Scorpio","degree":14,"minute":12,"deg":"14°12'","position":"14°12'14\" Scorpio","longitude":224.204003,"speed_longitude":0.069953,"retrograde":false,"element":"water","modality":"fixed"},"saturn":{"name":"Saturn","glyph":"♄","sign":"Capricorn","degree":3,"minute":25,"deg":"3°25'","position":"3°25'03\" Capricorn","longitude":273.41737,"speed_longitude":-0.049646,"retrograde":true,"element":"earth","modality":"cardinal"},"uranus":{"name":"Uranus","glyph":"♅","sign":"Taurus","degree":2,"minute":33,"deg":"2°33'","position":"2°33'17\" Taurus","longitude":32.554732,"speed_longitude":0.003038,"retrograde":false,"element":"earth","modality":"fixed"},"neptune":{"name":"Neptune","glyph":"♆","sign":"Pisces","degree":15,"minute":58,"deg":"15°58'","position":"15°58'04\" Pisces","longitude":345.967693,"speed_longitude":-0.021431,"retrograde":true,"element":"water","modality":"mutable"},"pluto":{"name":"Pluto","glyph":"♇","sign":"Capricorn","degree":19,"minute":29,"deg":"19°29'","position":"19°29'28\" Capricorn","longitude":289.491029,"speed_longitude":-0.022246,"retrograde":true,"element":"earth","modality":"cardinal"},"true_node":{"name":"True North Node","glyph":"☊","sign":"Leo","degree":5,"minute":51,"deg":"5°51'","position":"5°51'45\" Leo","longitude":125.862449,"speed_longitude":-0.004151,"retrograde":true,"element":"fire","modality":"fixed"}},"aspects":[{"bodies":["mars","uranus"],"aspect":"square","angle":90.0,"orb":0.452052,"orb_allowed":7.0,"state":"separating","label":"Mars square Uranus"},{"bodies":["saturn","uranus"],"aspect":"trine","angle":120.0,"orb":0.862637,"orb_allowed":7.0,"state":"applying","label":"Saturn trine Uranus"},{"bodies":["jupiter","neptune"],"aspect":"trine","angle":120.0,"orb":1.76369,"orb_allowed":7.0,"state":"applying","label":"Jupiter trine Neptune"}],"summary":{"sun_sign":"Leo","moon_sign":"Aries","retrograde":["mercury","mars","saturn"],"element_balance":{"fire":3,"earth":4,"air":1,"water":2},"modality_balance":{"cardinal":3,"fixed":5,"mutable":2},"major_aspects":14},"key_dates":[{"date_utc":"2026-11-01T14:37Z","timestamp":1793543820,"transit":"mercury","aspect":"trine","launch_point":"neptune","kind":"aspect","transit_retrograde":true,"label":"Mercury trine launch Neptune","key":"mercury:trine:neptune:2026-11-01T14:37Z"},{"date_utc":"2026-11-03T01:03Z","timestamp":1793667780,"transit":"mercury","aspect":"conjunction","launch_point":"jupiter","kind":"aspect","transit_retrograde":true,"label":"Mercury conjunction launch Jupiter","key":"mercury:conjunction:jupiter:2026-11-03T01:03Z"},{"date_utc":"2026-11-03T19:51Z","timestamp":1793735460,"transit":"sun","aspect":"square","launch_point":"sun","kind":"aspect","transit_retrograde":false,"label":"Sun square launch Sun","key":"sun:square:sun:2026-11-03T19:51Z"}],"returns":[],"counts":{"key_dates":68,"returned":50,"aspects":14},"card":{"format":"image/svg+xml","width":1200,"height":675,"svg":"<svg xmlns='http://www.w3.org/2000/svg' width='1200' height='675' viewBox='0 0 1200 675' role='img'><defs><radialGradien... (20,656 characters of SVG, shortened in this example)"}},"meta":{"engine":"astro-agents/1.8.2","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":"594bf4445128782b1d48baa8ebb4f9fcaf6101d05710596be0e7a93a8f2cc4a7","result_sha256":"f745d98ffd86d69db4b367a8cc2f32c9a46e5ddcd5d6911ba908f86a0f5bf12c","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.","convention":{"launch":"the UTC moment given in launch_datetime (ISO 8601 with Z or an offset, or unix seconds), read as is","positions":"geocentric apparent, true ecliptic and equinox of date, NASA/JPL DE440; no houses (no place)","key_dates":"exact UTC minute at which a transiting body's longitude equals a launch longitude (return = conjunction of a body with its own launch position) or that longitude +/- an aspect angle; daily samples, bisection to < 1 minute","hash":"result_sha256 covers the card SVG too: it is rendered from the result, with no clock or randomness"},"disclaimer":"Data for your own analysis — never a signal or forecast."},"example_note":"real output of engine 1.8.2; 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"}