Zodiac sign pair relations (public, no key)

GET

/public/compatibility/matrix

cURL

curl 'https://api.astroway.info/v1/public/compatibility/matrix'

All 78 unordered pairs of zodiac signs (each sign with itself included), each with the classical whole-sign relation: same, sextile, square, trine, opposition, or aversion for signs one or five apart, which classically do not see each other. tone follows Ptolemy (Tetrabiblos I.13): trine, sextile and same sign are harmonious, square and opposition challenging, aversion neutral. There is deliberately no 0-100 score: a pair of signs has no orb and no bodies for the synastry model to weigh, so any number would be invented. For a score, send two birth charts to POST /public/synastry. Static data, Cache-Control: public, max-age=604800, Vary: Accept-Language. localized (follows ?lang= / Accept-Language) holds lookup tables from the English identifiers in pairs to display names: signs, relations, tones, elements, modalities. The identifiers themselves never change.

Parameters

Query Parameters

lang

string

Example

en

Language for this call, overriding Accept-Language. The canonical per-call form: a page that renders in one language passes it here rather than reconfiguring its client. Unknown or inactive codes fall back to uk.

fields

string

Comma-separated dotted paths, relative to data, to keep in the response. A path is applied to every element of an array, so planets.name means the name of each planet. Paths that match nothing come back in _fields_unmatched; a list where nothing matches at all is a 400, because an empty object would be a confident wrong answer.

Example

planets.name,planets.longitude

precision

integer

<= 15

Round every non-integer number in the response to this many decimal places. Integers are left alone, because an id is not a measurement. Ecliptic longitudes ship with fourteen decimals by default; 2 is about a tenth of an arcminute.

Example

Header Parameters

Accept-Language

string

BCP-47 language (e.g. uk, en, de). Set it once on your HTTP client as its default; for a single call, ?lang= overrides it. Unknown or inactive codes fall back to uk.

Responses

200

application/json

object

boolean

data

object

pairs

Array<object>

nullable

object

signA

string

nullable

signB

string

nullable

distance

number

nullable

relation

string

nullable

tone

string

nullable

elements

Array<string>

nullable

modalities

Array<string>

nullable

samePolarity

boolean

nullable

count

number

nullable

localized

object

signs

object

aries

string

nullable

taurus

string

nullable

gemini

string

nullable

cancer

string

nullable

leo

string

nullable

virgo

string

nullable

libra

string

nullable

scorpio

string

nullable

sagittarius

string

nullable

capricorn

string

nullable

aquarius

string

nullable

pisces

string

nullable

relations

object

same

string

nullable

aversion

string

nullable

sextile

string

nullable

square

string

nullable

trine

string

nullable

opposition

string

nullable

tones

object

harmonious

string

nullable

neutral

string

nullable

challenging

string

nullable

elements

object

fire

string

nullable

earth

string

nullable

air

string

nullable

water

string

nullable

modalities

object

cardinal

string

nullable

fixed

string

nullable

mutable

string

nullable

_footer

Free-tier watermark, present on every public response. Keys on a paid plan do not receive it.

string

Example

{
  "ok": true,
  "data": {
    "pairs": [
      {
        "signA": "aries",
        "signB": "aries",
        "distance": 0,
        "relation": "same",
        "tone": "harmonious",
        "elements": [
          "fire",
          "fire"
        ],
        "modalities": [
          "cardinal",
          "cardinal"
        ],
        "samePolarity": true
      },
      {
        "signA": "aries",
        "signB": "taurus",
        "distance": 1,
        "relation": "aversion",
        "tone": "neutral",
        "elements": [
          "fire",
          "earth"
        ],
        "modalities": [
          "cardinal",
          "fixed"
        ],
        "samePolarity": false
      }
    ],
    "count": 78,
    "localized": {
      "signs": {
        "aries": "Widder",
        "taurus": "Stier",
        "gemini": "Zwillinge",
        "cancer": "Krebs",
        "leo": "Löwe",
        "virgo": "Jungfrau",
        "libra": "Waage",
        "scorpio": "Skorpion",
        "sagittarius": "Schütze",
        "capricorn": "Steinbock",
        "aquarius": "Wassermann",
        "pisces": "Fische"
      },
      "relations": {
        "same": "Gleiches Zeichen",
        "aversion": "Aversion",
        "sextile": "Sextil",
        "square": "Quadrat",
        "trine": "Trigon",
        "opposition": "Opposition"
      },
      "tones": {
        "harmonious": "Harmonisch",
        "neutral": "Neutral",
        "challenging": "Herausfordernd"
      },
      "elements": {
        "fire": "Feuer",
        "earth": "Erde",
        "air": "Luft",
        "water": "Wasser"
      },
      "modalities": {
        "cardinal": "Kardinal",
        "fixed": "Fix",
        "mutable": "Veränderlich"
      }
    }
  },
  "_footer": "Powered by astroway.api - get your own key at https://api.astroway.info"
}

400

Invalid sign or date

application/json

Example

{
  "ok": false,
  "error": {
    "code": "INVALID_SIGN",
    "message": "sign must be one of the 12 zodiac signs"
  }
}

Suggest an edit

// Previous

Place search (public, no key)

Next //

Daily Horoscope (public, no key)