Zodiac sign pair relations (public, no key)

GET

/public/compatibility/matrix

Code sample: cURL

request.sh

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

▸ Спробувати GET /public/compatibility/matrix

• Production

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.

Parameters

Query Parameters

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

4

Responses

200

OK

Media type application/json

object

ok

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

_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
  },
  "_footer": "Powered by astroway.api - get your own key at https://api.astroway.info"
}

400

Invalid sign or date

Media type application/json

Example

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