{"id":"finance/token-synastry","method":"POST","url":"https://astro-agent.dev/v1/finance/token-synastry","price_usd":"0.25","tier":"premium","title":"Token synastry (two launch skies compared)","summary":"Compatibility by sky geometry of two tokens: the cross-aspects between their launch skies, harmonious and tense counts, the tightest aspects and a geometry score, with a shareable SVG card.","description":"Two launch moments (UTC block times) compared like a synastry, without houses: every major cross-aspect between token A's and token B's planets with its orb and exactness, harmonious (trine, sextile) / tense (square, opposition) / conjunction counts, the five tightest aspects as readable labels, and geometry_score = 100 x H / (H + T) where H and T sum the exactness (1 - orb / orb allowed) of harmonious and tense aspects -- an aggregate of geometry, defined in the response, not a rating. Next to it, 'substance' says how much geometry the score stands on: aspects_total, counts (harmonious, tense, conjunction), tight_aspects (orb <= 1 deg), the tightest aspect with its orb, the orb threshold, the summed exactness and a confidence label by tight aspects (rich >= 7, moderate 3-6, thin <= 2; the rule is in the response). Rows ready for pandas; result.card.svg is a server-rendered card naming both tokens, with the substance under the score. Data only — never a signal or forecast.","input_schema":{"type":"object","required":["token_a","token_b"],"properties":{"token_a":{"description":"A token: its launch_datetime (string or unix seconds), or {launch_datetime, chain?, address?, symbol?, name?}.","oneOf":[{"type":"string"},{"type":"integer"},{"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"]},"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'."}}}]},"token_b":{"description":"A token: its launch_datetime (string or unix seconds), or {launch_datetime, chain?, address?, symbol?, name?}.","oneOf":[{"type":"string"},{"type":"integer"},{"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"]},"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'."}}}]},"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":{"token_a":{"launch_datetime":"2018-08-03T19:28:24Z","symbol":"USDC"},"token_b":{"launch_datetime":"2020-09-14T18:11:26Z","symbol":"UNI"}},"example_response":{"endpoint":"finance/token-synastry","result":{"token_a":{"launch_utc":"2018-08-03T19:28:24Z","token":{"symbol":"USDC"},"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"}}},"token_b":{"launch_utc":"2020-09-14T18:11:26Z","token":{"symbol":"UNI"},"planets":{"sun":{"name":"Sun","glyph":"☉","sign":"Virgo","degree":22,"minute":22,"deg":"22°22'","position":"22°22'36\" Virgo","longitude":172.376774,"speed_longitude":0.974618,"retrograde":false,"element":"earth","modality":"mutable"},"moon":{"name":"Moon","glyph":"☽","sign":"Leo","degree":15,"minute":23,"deg":"15°23'","position":"15°23'01\" Leo","longitude":135.383706,"speed_longitude":14.125064,"retrograde":false,"element":"fire","modality":"fixed"},"mercury":{"name":"Mercury","glyph":"☿","sign":"Libra","degree":13,"minute":38,"deg":"13°38'","position":"13°38'42\" Libra","longitude":193.644919,"speed_longitude":1.440574,"retrograde":false,"element":"air","modality":"cardinal"},"venus":{"name":"Venus","glyph":"♀","sign":"Leo","degree":9,"minute":18,"deg":"9°18'","position":"9°18'49\" Leo","longitude":129.313686,"speed_longitude":1.116749,"retrograde":false,"element":"fire","modality":"fixed"},"mars":{"name":"Mars","glyph":"♂","sign":"Aries","degree":27,"minute":58,"deg":"27°58'","position":"27°58'10\" Aries","longitude":27.9694,"speed_longitude":-0.071548,"retrograde":true,"element":"fire","modality":"cardinal"},"jupiter":{"name":"Jupiter","glyph":"♃","sign":"Capricorn","degree":17,"minute":24,"deg":"17°24'","position":"17°24'41\" Capricorn","longitude":287.411346,"speed_longitude":0.005623,"retrograde":false,"element":"earth","modality":"cardinal"},"saturn":{"name":"Saturn","glyph":"♄","sign":"Capricorn","degree":25,"minute":30,"deg":"25°30'","position":"25°30'29\" Capricorn","longitude":295.50806,"speed_longitude":-0.023401,"retrograde":true,"element":"earth","modality":"cardinal"},"uranus":{"name":"Uranus","glyph":"♅","sign":"Taurus","degree":10,"minute":19,"deg":"10°19'","position":"10°19'37\" Taurus","longitude":40.326999,"speed_longitude":-0.023548,"retrograde":true,"element":"earth","modality":"fixed"},"neptune":{"name":"Neptune","glyph":"♆","sign":"Pisces","degree":19,"minute":27,"deg":"19°27'","position":"19°27'58\" Pisces","longitude":349.46608,"speed_longitude":-0.027565,"retrograde":true,"element":"water","modality":"mutable"},"pluto":{"name":"Pluto","glyph":"♇","sign":"Capricorn","degree":22,"minute":34,"deg":"22°34'","position":"22°34'48\" Capricorn","longitude":292.58011,"speed_longitude":-0.009238,"retrograde":true,"element":"earth","modality":"cardinal"},"true_node":{"name":"True North Node","glyph":"☊","sign":"Gemini","degree":24,"minute":58,"deg":"24°58'","position":"24°58'28\" Gemini","longitude":84.974582,"speed_longitude":-0.125119,"retrograde":true,"element":"air","modality":"mutable"}}},"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 datetimes 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},"points":["sun","moon","mercury"],"score":{"name":"geometry_score","formula":"100 x H / (H + T), rounded to 0.1; H = sum of exactness over harmonious cross-aspects (trine, sextile), T = the same over tense ones (square, opposition); exactness = 1 - orb / orb_allowed; conjunctions and minor aspects are counted, not scored; null when H + T = 0","meaning":"an aggregate of the sky geometry between two launch moments, nothing else: not a rating, a prediction or a signal"}},"cross_aspects":[{"a":"pluto","b":"neptune","aspect":"sextile","symbol":"⚹","angle":60.0,"orb":0.024949,"orb_allowed":5.0,"exactness":0.99501,"nature":"harmonious","label":"Pluto_a ⚹ Neptune_b, orb 0.0°"},{"a":"sun","b":"uranus","aspect":"square","symbol":"□","angle":90.0,"orb":1.0796,"orb_allowed":9.0,"exactness":0.880044,"nature":"tense","label":"Sun_a □ Uranus_b, orb 1.1°"},{"a":"jupiter","b":"moon","aspect":"square","symbol":"□","angle":90.0,"orb":1.179703,"orb_allowed":9.0,"exactness":0.868922,"nature":"tense","label":"Jupiter_a □ Moon_b, orb 1.2°"}],"score":{"geometry_score":53.6,"harmonious_weight":5.136689,"tense_weight":4.444399},"substance":{"aspects_total":34,"tight_aspects":1,"tight_orb_deg":1.0,"counts":{"harmonious":10,"tense":12,"conjunction":12,"minor":0},"tightest":{"label":"Pluto_a sextile Neptune_b","orb_deg":0.02},"orb_allowed_deg":10.0,"weighted_strength":15.64,"confidence":"thin","confidence_rule":"by tight_aspects (cross-aspects with orb <= 1 deg, any aspect type): thin if <= 2, moderate if 3-6, rich if >= 7 (about 18% / 65% / 17% of 300 random launch pairs, 2009-2026); a ratio drawn from few close aspects is a thin sample, the score formula is unchanged"},"aspect_counts":{"harmonious":10,"tense":12,"neutral":12,"minor":0,"total":34},"tightest":["Pluto_a ⚹ Neptune_b, orb 0.0°","Sun_a □ Uranus_b, orb 1.1°","Jupiter_a □ Moon_b, orb 1.2°"],"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... (21,596 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":"e59fc0d97d7e87068a23f9fb348ab954cff2dd7efb92cfae16f6a1f029ba5037","result_sha256":"0af1d2bb9cf12f44d3a06249a667b6e82d6ef0aab2ee5ad4c1bf951072367db2","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"},"score":{"name":"geometry_score","formula":"100 x H / (H + T), rounded to 0.1; H = sum of exactness over harmonious cross-aspects (trine, sextile), T = the same over tense ones (square, opposition); exactness = 1 - orb / orb_allowed; conjunctions and minor aspects are counted, not scored; null when H + T = 0","meaning":"an aggregate of the sky geometry between two launch moments, nothing else: not a rating, a prediction or a signal"},"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"}