openephemeris-com · Schema
BiWheelRequest
Bi-wheel visualization request. Each subject may carry birth params OR precomputed positions.
CompanyAstrologyArtificial IntelligenceAstronomyData
Properties
| Name | Type | Description |
|---|---|---|
| configuration | object | Engine-referenced natal configuration (house system, orientation, object set). Applies to both rings. |
| subject_a | object | Inner ring subject. |
| subject_b | object | Outer ring subject. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/openephemeris-com/json-schema/openephemeris-com-bi-wheel-request-schema.json",
"title": "BiWheelRequest",
"description": "Bi-wheel visualization request. Each subject may carry birth params OR precomputed positions.",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/openephemeris-com-visualization-api-openapi.yml#/components/schemas/BiWheelRequest",
"additionalProperties": false,
"properties": {
"configuration": {
"allOf": [
{
"$ref": "#/$defs/NatalConfig"
}
],
"description": "Engine-referenced natal configuration (house system, orientation, object set). Applies to both rings."
},
"subject_a": {
"allOf": [
{
"$ref": "#/$defs/WheelSubject"
}
],
"description": "Inner ring subject."
},
"subject_b": {
"allOf": [
{
"$ref": "#/$defs/WheelSubject"
}
],
"description": "Outer ring subject."
}
},
"required": [
"subject_a",
"subject_b"
],
"type": "object",
"$defs": {
"AsteroidGroupEnum": {
"description": "Predefined categories of asteroids and minor planets.",
"enum": [
"major",
"centaur",
"tno",
"muse",
"main_belt"
],
"title": "AsteroidGroupEnum",
"type": "string"
},
"AyanamsaEnum": {
"description": "Supported sidereal ayanamsa options (krishnamurti is KP old, krishnamurti_vp291 KP new). All six are computed from the same IAU 2006 general-precession model, so each is epoch-dependent rather than a frozen constant; they differ by up to ~2.3 degrees, which is enough to move a body across a sign boundary. Defaults to lahiri when zodiac_type is sidereal and no system is named.",
"enum": [
"lahiri",
"fagan_bradley",
"krishnamurti",
"krishnamurti_vp291",
"raman",
"yukteshwar"
],
"title": "AyanamsaEnum",
"type": "string"
},
"BirthLocation": {
"additionalProperties": false,
"description": "Location context for birth data: coordinates plus timezone.",
"properties": {
"city": {
"anyOf": [
{
"maxLength": 120,
"type": "string"
}
],
"description": "City name",
"title": "City"
},
"country": {
"anyOf": [
{
"maxLength": 120,
"type": "string"
}
],
"description": "Country",
"title": "Country"
},
"elevation": {
"anyOf": [
{
"type": "number"
}
],
"description": "Elevation in meters. Accepted and echoed back unchanged; it does not affect planetary positions, which are computed geocentrically. Elevation changes results only where it is taken as the `elev` query parameter: /eclipse/solar/local (local circumstances) and /time/solar-event plus /ephemeris/agro/* (horizon rise/set times).",
"title": "Elevation"
},
"latitude": {
"allOf": [
{
"$ref": "#/$defs/CoordinateInput"
}
],
"description": "Latitude coordinate"
},
"location_name": {
"anyOf": [
{
"maxLength": 200,
"type": "string"
}
],
"description": "Birthplace display name (e.g. \"Dallas, TX\"). Never affects calculations — coordinates and timezone are the only location facts the engine reads. Echoed back verbatim where the response carries an echo block: as subject.location_name on chart routes that echo a subject (natal, draconic, progressed, synastry, natal-transits, overlay, natal/batch items, predictive transit-chart), inside search_summary on /electional/natal-angle-crossings, metadata on /acg/midpoints, and natal on /human-design/transit-chart. Omitted from the response when not sent.",
"title": "Location Name"
},
"longitude": {
"allOf": [
{
"$ref": "#/$defs/CoordinateInput"
}
],
"description": "Longitude coordinate"
},
"region": {
"anyOf": [
{
"maxLength": 120,
"type": "string"
}
],
"description": "State/region",
"title": "Region"
},
"timezone": {
"allOf": [
{
"$ref": "#/$defs/TimezoneInput"
}
],
"description": "Timezone information"
}
},
"required": [
"latitude",
"longitude",
"timezone"
],
"title": "BirthLocation",
"type": "object"
},
"CoordinateFrameEnum": {
"description": "Reference frame for reported coordinates.",
"enum": [
"ecliptic",
"equatorial",
"horizontal"
],
"title": "CoordinateFrameEnum",
"type": "string"
},
"CoordinateInput": {
"additionalProperties": false,
"description": "Flexible coordinate input supporting multiple formats.",
"properties": {
"components": {
"anyOf": [
{
"additionalProperties": {
"anyOf": [
{
"type": "integer"
},
{
"type": "number"
},
{
"type": "string"
}
]
},
"type": "object"
}
],
"description": "Separate degree components with direction",
"title": "Components"
},
"decimal": {
"anyOf": [
{
"type": "number"
}
],
"description": "Decimal degrees (-90 to 90 for lat, -180 to 180 for lon)",
"title": "Decimal"
},
"dms": {
"anyOf": [
{
"maxLength": 64,
"type": "string"
}
],
"description": "Degrees, minutes, seconds string (e.g., '40°42'46\"N')",
"title": "Dms"
}
},
"title": "CoordinateInput",
"type": "object"
},
"CoordinateSystemEnum": {
"description": "Coordinate system used for calculations.",
"enum": [
"geocentric",
"topocentric",
"heliocentric",
"barycentric"
],
"title": "CoordinateSystemEnum",
"type": "string"
},
"DateTimeInput": {
"additionalProperties": false,
"description": "Date/time input in ISO-8601, component, or Julian day form. A value that states a clock time must also state its zone, either as a suffix on the string or via the `timezone` field below.",
"properties": {
"components": {
"anyOf": [
{
"additionalProperties": {
"type": "integer"
},
"type": "object"
}
],
"description": "Date/time components (year, month, day, and optionally hour, minute, second). If hour/minute are present, pass `timezone` alongside them; without it the request is rejected with 400 ambiguous_datetime. Omit the clock entirely and the date resolves to 12:00 UTC.",
"title": "Components"
},
"iso": {
"anyOf": [
{
"maxLength": 64,
"type": "string"
}
],
"description": "ISO-8601 datetime (supported range 1550–2650 CE, JPL DE440). If it states a clock time it must carry its zone: either a 'Z'/±HH:MM suffix on the string (\"1987-07-15T09:01:00-05:00\"), or a `timezone` passed alongside it. A zone-less clock time is rejected with 400 ambiguous_datetime — it is not read as UTC. A date-only value (\"1987-07-15\") has no clock to be ambiguous about and resolves to 12:00 UTC.",
"title": "Iso"
},
"julian_day": {
"anyOf": [
{
"format": "double",
"type": "number"
}
],
"description": "Julian Day Number (always UTC-based, so it needs no zone)",
"title": "Julian Day"
},
"timezone": {
"$ref": "#/$defs/TimezoneInput",
"description": "Zone the wall-clock time in `iso`/`components` belongs to, e.g. {\"iana_name\": \"America/Chicago\"}. Supply this to keep a local time as written instead of adding a UTC offset yourself. Ignored when the datetime already carries its own 'Z'/±HH:MM suffix."
}
},
"title": "DateTimeInput",
"type": "object"
},
"FixedStarCatalogEnum": {
"description": "Fixed star catalog snapshots.",
"enum": [
"bright_mag3",
"bright_mag5",
"royal_stars",
"parans_key"
],
"title": "FixedStarCatalogEnum",
"type": "string"
},
"FixedStarConfig": {
"additionalProperties": false,
"description": "Configuration for fixed star calculations.",
"properties": {
"catalog_version": {
"allOf": [
{
"$ref": "#/$defs/FixedStarCatalogEnum"
}
],
"default": "bright_mag5",
"description": "Catalog snapshot identifier"
},
"include": {
"default": false,
"description": "Toggle fixed star conjunction calculations",
"title": "Include",
"type": "boolean"
},
"magnitude_limit": {
"default": 6,
"description": "Maximum magnitude (lower = brighter)",
"maximum": 10,
"minimum": 0,
"title": "Magnitude Limit",
"type": "number"
},
"orb": {
"default": 2,
"description": "Orb in degrees for fixed star hits",
"maximum": 5,
"minimum": 0.1,
"title": "Orb",
"type": "number"
},
"stars": {
"anyOf": [
{
"items": {
"type": "string"
},
"maxItems": 256,
"type": "array"
}
],
"description": "Optional whitelist of fixed stars to evaluate",
"title": "Stars"
}
},
"title": "FixedStarConfig",
"type": "object"
},
"HouseSystemEnum": {
"description": "Supported house systems.",
"enum": [
"P",
"K",
"O",
"R",
"C",
"E",
"W"
],
"title": "HouseSystemEnum",
"type": "string"
},
"NatalConfig": {
"additionalProperties": false,
"description": "Declarative configuration for natal calculations.",
"properties": {
"ascendant_on_left": {
"default": true,
"description": "When true (default), the Ascendant is placed at the 9 o'clock (West/left) position � matching the convention used by Astro.com, Solar Fire, and all major astrology software. Set to false to use the ecliptic-fixed (Aries-pinned) orientation instead.",
"title": "Ascendant on Left",
"type": [
"boolean",
"null"
]
},
"aspect_backing_discs": {
"default": true,
"description": "Wheel rendering only. When true (default), each aspect glyph sits on a small backing disc so it stays legible over crossing lines. Set false to draw bare glyphs. Honoured by /visualization/chart-wheel and /visualization/bi-wheel; rejected with 422 elsewhere.",
"title": "Aspect Backing Discs",
"type": [
"boolean",
"null"
]
},
"aspect_orbs": {
"anyOf": [
{
"additionalProperties": {
"type": "number"
},
"type": "object"
}
],
"description": "Caller-supplied orb allowances in degrees for the aspect lines drawn on the wheel, keyed by aspect name (conjunction, opposition, trine, square, sextile, and the minors quincunx, semisextile, semisquare, sesquiquadrate, quintile, biquintile). Same shape and semantics as ChartConfiguration.aspect_orbs: overrides the default table for the aspects named; aspects not named keep their defaults, and naming a minor is what turns it on. Setting an orb to 0 turns that aspect off entirely. An unknown aspect name is rejected with 422. Honoured by /visualization/chart-wheel and /visualization/bi-wheel (planet-to-planet lines; the include_angle_aspects lines keep their own table) and by /ephemeris/relocation (its aspect grid). /acg/midpoints, /ephemeris/natal/batch and /electional/natal-angle-crossings compute no aspect grid and reject the field with 422 rather than ignore it.",
"title": "Aspect Orbs"
},
"asteroid_groups": {
"anyOf": [
{
"items": {
"$ref": "#/$defs/AsteroidGroupEnum"
},
"maxItems": 16,
"type": "array"
}
],
"description": "Optional thematic asteroid groups to include alongside base object_set",
"title": "Asteroid Groups"
},
"ayanamsa": {
"$ref": "#/$defs/AyanamsaEnum",
"description": "Sidereal ayanamsa (required when zodiac_type=sidereal)"
},
"coordinate_frame": {
"allOf": [
{
"$ref": "#/$defs/CoordinateFrameEnum"
}
],
"default": "ecliptic",
"description": "Reference frame for returned positions"
},
"coordinate_system": {
"allOf": [
{
"$ref": "#/$defs/CoordinateSystemEnum"
}
],
"default": "geocentric",
"description": "Origin the planetary positions are measured from. `geocentric` (default) is the apparent place from the Earth's centre. `topocentric` places every body for the subject's own coordinates (diurnal parallax; observer height 0, no refraction; lunar nodes and apsides are orbit geometry and are not displaced). `heliocentric` and `barycentric` place bodies as seen from the Sun's centre or the solar-system barycentre (light-time-corrected, true ecliptic of date); with no observer on Earth there is no horizon, so the response carries no angles or houses, the lunar nodes and apsides are listed in omitted_bodies (reason unsupported_in_frame), and options that need a horizon (include_visual, include_dignities, include_angle_aspects, include_hermetic_lots, sect_determination, hemisphere_emphasis, include_fixed_stars, human_design_gates) are refused with 422. The frame actually used is echoed in calculation_metadata. Routes that cannot honour a value return 422 listing the valid ones."
},
"custom_objects": {
"description": "Explicit body/point slugs to include, additive on top of object_set (and the entire set when object_set='custom'). Ephemeris bodies: sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, north_node, true_node, lilith, lilith_true, chiron, pholus, lilith_interpolated, eris, sedna, makemake, haumea, quaoar, orcus, ixion, varuna, cupido, hades, zeus, kronos, apollon, admetos, vulkanus, poseidon, eros, sappho, lilith_asteroid, nessus, chariklo, amor, betulia, icarus, apollo, adonis, phaethon, astraea, hebe, flora, metis, parthenope, victoria, egeria, irene, massalia, isis, anubis, odysseus, tolosa, medusa, ambrosia, aletheia, thule, polyxo, myrrha, valentine, hercynia, nestor, siva, atlantis, aphrodite, prometheus, epimetheus, shaposhnikov, lick, huya, ceres, pallas, juno, vesta, hygiea, eunomia, psyche, europa_asteroid, cybele, sylvia, thisbe, camilla, iris, davida, euphrosyne, interamnia. Angle-derived points: vertex, anti_vertex, south_node, part_of_fortune, equatorial_ascendant (alias east_point), equatorial_descendant. Unknown slugs are ignored.",
"items": {
"type": "string"
},
"maxItems": 128,
"title": "Custom Objects",
"type": [
"array",
"null"
]
},
"fixed_star_options": {
"$ref": "#/$defs/FixedStarConfig",
"description": "Detailed fixed star options"
},
"house_system": {
"allOf": [
{
"$ref": "#/$defs/HouseSystemEnum"
}
],
"default": "P",
"description": "House system (SE §6.2)"
},
"node_source": {
"allOf": [
{
"$ref": "#/$defs/NodeSourceEnum"
}
],
"default": "true_osculating",
"description": "Node/apsides mode (SE §2.2)"
},
"object_set": {
"allOf": [
{
"$ref": "#/$defs/ObjectSetEnum"
}
],
"default": "modern_plus_chiron",
"description": "Celestial object bundle"
},
"show_aspect_glyphs": {
"default": true,
"description": "Wheel rendering only. When true (default), an aspect glyph is drawn at the midpoint of each aspect line. Set false to draw the lines alone. Honoured by /visualization/chart-wheel and /visualization/bi-wheel; rejected with 422 elsewhere.",
"title": "Show Aspect Glyphs",
"type": [
"boolean",
"null"
]
},
"zodiac_type": {
"allOf": [
{
"$ref": "#/$defs/ZodiacTypeEnum"
}
],
"default": "tropical",
"description": "Zodiac reference (tropical or sidereal)"
}
},
"title": "NatalConfig",
"type": "object"
},
"NodeSourceEnum": {
"description": "Node/apsides calculation modes (SE §2.2).",
"enum": [
"true_osculating",
"mean",
"mean_apsides"
],
"title": "NodeSourceEnum",
"type": "string"
},
"ObjectSetEnum": {
"description": "Standardized celestial object bundles.",
"enum": [
"traditional_7",
"modern_10",
"modern_plus_chiron",
"asteroids_major",
"full",
"custom"
],
"title": "ObjectSetEnum",
"type": "string"
},
"PositionInput": {
"additionalProperties": false,
"description": "A precomputed body position for direct wheel rendering. Supply instead of birth params to draw an arbitrary chart (e.g. solar arc, progressed/transit hybrid).",
"properties": {
"body": {
"description": "Canonical lowercase body key (e.g. 'sun', 'moon', 'north_node'). Unknown keys render with a generic marker and the key as label.",
"minLength": 1,
"title": "Body",
"type": "string"
},
"longitude": {
"description": "Ecliptic longitude in degrees [0, 360).",
"maximum": 360,
"minimum": 0,
"title": "Longitude",
"type": "number"
},
"retrograde": {
"description": "Explicit retrograde flag. Defaults to speed < 0 when speed is given, else false.",
"title": "Retrograde",
"type": "boolean"
},
"speed": {
"description": "Longitudinal speed in deg/day. When present and negative (and 'retrograde' is omitted), the body is treated as retrograde.",
"title": "Speed",
"type": "number"
}
},
"required": [
"body"
],
"title": "PositionInput",
"type": "object"
},
"TimezoneInput": {
"additionalProperties": false,
"description": "Timezone input using IANA names or UTC offsets.",
"properties": {
"fold_preference": {
"description": "Which occurrence to use when the naive local datetime falls in a fall-back fold (a repeated hour): 'earlier' (default — first occurrence) or 'later'. Only meaningful for naive datetimes; the response reports datetime_status=ambiguous_fold either way so the ambiguity can be surfaced to the user.",
"enum": [
"earlier",
"later"
],
"title": "Fold Preference",
"type": "string"
},
"iana_name": {
"anyOf": [
{
"maxLength": 128,
"type": "string"
}
],
"description": "IANA timezone name",
"title": "Iana Name"
},
"time_standard": {
"description": "How to interpret a naive local datetime when this zone is applied. 'auto' (default): resolve through the historical-correction overlay where one covers the region/era, then IANA tzdata. 'standard': force the zone's standard (non-daylight) offset — for callers who KNOW the recorded time was standard time regardless of what tzdata believes. 'daylight': force standard+1h. Forcing either marks the resolution tz_confidence=client_override. Ignored when the datetime carries its own Z/±HH:MM suffix or when utc_offset is used.",
"enum": [
"auto",
"standard",
"daylight"
],
"title": "Time Standard",
"type": "string"
},
"utc_offset": {
"anyOf": [
{
"type": "number"
}
],
"description": "UTC offset in hours",
"title": "Utc Offset"
}
},
"title": "TimezoneInput",
"type": "object"
},
"WheelHouses": {
"additionalProperties": false,
"description": "House geometry for a precomputed wheel ring. Required for the inner/single ring to draw houses and anchor orientation; the outer overlay ring does not require it.",
"properties": {
"ascendant": {
"description": "Ascendant in degrees [0, 360). Used for ASC-pinned orientation.",
"maximum": 360,
"minimum": 0,
"title": "Ascendant",
"type": "number"
},
"cusps": {
"description": "12 absolute-degree house cusps.",
"items": {
"maximum": 360,
"minimum": 0,
"type": "number"
},
"maxItems": 12,
"minItems": 12,
"title": "Cusps",
"type": "array"
},
"house_system": {
"description": "House system code label (e.g. 'P').",
"title": "House System",
"type": "string"
},
"midheaven": {
"description": "Midheaven in degrees [0, 360).",
"maximum": 360,
"minimum": 0,
"title": "Midheaven",
"type": "number"
}
},
"required": [
"cusps",
"ascendant"
],
"title": "WheelHouses",
"type": "object"
},
"WheelSubject": {
"additionalProperties": false,
"description": "A wheel ring subject. Supply EITHER birth params (birth_datetime + birth_location, cast internally) OR a precomputed 'positions' array (rendered directly). When 'positions' is present, birth params are ignored for that subject.",
"properties": {
"birth_datetime": {
"allOf": [
{
"$ref": "#/$defs/DateTimeInput"
}
],
"description": "Birth date and time. Ignored when 'positions' is supplied."
},
"birth_location": {
"allOf": [
{
"$ref": "#/$defs/BirthLocation"
}
],
"description": "Birth location. Ignored when 'positions' is supplied."
},
"houses": {
"allOf": [
{
"$ref": "#/$defs/WheelHouses"
}
],
"description": "Optional house geometry for a positions ring (inner/single ring)."
},
"name": {
"description": "Optional display label for the ring.",
"maxLength": 120,
"minLength": 1,
"title": "Name",
"type": "string"
},
"positions": {
"description": "Precomputed body positions. When present, the ring is rendered from these longitudes and birth params are ignored.",
"items": {
"$ref": "#/$defs/PositionInput"
},
"maxItems": 256,
"title": "Positions",
"type": "array"
}
},
"title": "WheelSubject",
"type": "object"
},
"ZodiacTypeEnum": {
"description": "Supported zodiac frameworks.",
"enum": [
"tropical",
"sidereal"
],
"title": "ZodiacTypeEnum",
"type": "string"
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/openephemeris-com-bi-wheel-request"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.