Feng Shui API reference

curl -X POST "https://roxyapi.com/api/v2/feng-shui/kua" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1985-07-15","gender":"male"}'

{
  "kua": 6,
  "rawKua": 6,
  "reassigned": false,
  "gender": "male",
  "group": "west",
  "solarYear": 1985,
  "boundaryDate": "1985-02-04",
  "trigram": {
    "number": 4,
    "chinese": "巽",
    "english": "Wind",
    "nameLocalized": "Viento",
    "pinyin": "Xùn",
    "symbol": "☴",
    "binary": "011",
    "element": "Wood",
    "elementLocalized": "Madera",
    "direction": "Southeast",
    "directionLocalized": "Sureste",
    "familyMember": "Eldest Daughter"
  },
  "sectors": [
    {
      "direction": "Southeast",
      "star": "sheng-chi",
      "starName": "Sheng Chi",
      "starNameLocalized": "Aliento generador",
      "nature": "auspicious",
      "rank": 1,
      "domain": "Growth and income"
    }
  ],
  "conventions": {
    "yearBoundary": "li-chun"
  }
}

curl "https://roxyapi.com/api/v2/feng-shui/kua/8" \
  -H "X-API-Key: YOUR_KEY"

{
  "number": 8,
  "group": "west",
  "trigram": {
    "number": 4,
    "chinese": "巽",
    "english": "Wind",
    "nameLocalized": "Viento",
    "pinyin": "Xùn",
    "symbol": "☴",
    "binary": "011",
    "element": "Wood",
    "elementLocalized": "Madera",
    "direction": "Southeast",
    "directionLocalized": "Sureste",
    "familyMember": "Eldest Daughter"
  },
  "sectors": [
    {
      "direction": "Southeast",
      "star": "sheng-chi",
      "starName": "Sheng Chi",
      "starNameLocalized": "Aliento generador",
      "nature": "auspicious",
      "rank": 1,
      "domain": "Growth and income"
    }
  ]
}

curl -X POST "https://roxyapi.com/api/v2/feng-shui/eight-mansions" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kua":6,"date":"1985-07-15","gender":"male","yearBoundary":"li-chun"}'

{
  "kua": 6,
  "group": "west",
  "trigram": {
    "number": 4,
    "chinese": "巽",
    "english": "Wind",
    "nameLocalized": "Viento",
    "pinyin": "Xùn",
    "symbol": "☴",
    "binary": "011",
    "element": "Wood",
    "elementLocalized": "Madera",
    "direction": "Southeast",
    "directionLocalized": "Sureste",
    "familyMember": "Eldest Daughter"
  },
  "sectors": [
    {
      "direction": "Southeast",
      "star": "sheng-chi",
      "starName": "Sheng Chi",
      "starNameLocalized": "Aliento generador",
      "chinese": "生氣",
      "pinyin": "Shēng Qì",
      "nature": "auspicious",
      "rank": 1,
      "domain": "Growth and income",
      "trigram": {
        "number": 4,
        "chinese": "巽",
        "english": "Wind",
        "nameLocalized": "Viento",
        "pinyin": "Xùn",
        "symbol": "☴",
        "binary": "011",
        "element": "Wood",
        "elementLocalized": "Madera",
        "direction": "Southeast",
        "directionLocalized": "Sureste",
        "familyMember": "Eldest Daughter"
      },
      "reading": "The West sector reads Sheng Chi for Kua 6. This is one of the four favourable sectors for Kua 6, ranked 1 of four. The generating breath, and the strongest of the four favourable sectors. It is the direction to face while working, to seat a main door in, and to put a desk against, because it reads as advancement, new business and the kind of momentum that compounds. Where a household has to choose one sector to get right, this is the one."
    }
  ],
  "bestSector": "Southeast",
  "worstSector": "Southeast",
  "facingSector": {
    "direction": "Southeast",
    "star": "sheng-chi",
    "nature": "auspicious"
  },
  "conventions": {
    "yearBoundary": "li-chun"
  }
}

curl -X POST "https://roxyapi.com/api/v2/feng-shui/flying-stars/natal" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"period":9,"facing":"wu","facingDegrees":180}'

{
  "period": 9,
  "facing": {
    "id": "wu",
    "label": "S2",
    "chinese": "午",
    "pinyin": "Wǔ",
    "direction": "Southeast",
    "yuan": "heaven",
    "polarity": "yin",
    "startDegree": 172.5,
    "endDegree": 187.5
  },
  "sitting": {
    "id": "wu",
    "label": "S2",
    "chinese": "午",
    "pinyin": "Wǔ",
    "direction": "Southeast",
    "yuan": "heaven",
    "polarity": "yin",
    "startDegree": 172.5,
    "endDegree": 187.5
  },
  "facingDegrees": 180,
  "straddling": false,
  "mountainCenterStar": 8,
  "waterCenterStar": 8,
  "mountainFlight": "reverse",
  "waterFlight": "forward",
  "structure": {
    "id": "double-sitting",
    "name": "Double Star at Sitting",
    "chinese": "雙星到坐",
    "meaning": "Both prosperous stars gather at the back of the building. Good for health, for family and for anyone who works from home, weaker for income arriving from outside."
  },
  "palaces": [
    {
      "palace": "Southeast",
      "base": 8,
      "period": 8,
      "mountain": 8,
      "water": 8,
      "combination": {
        "id": "8-9",
        "name": "Prosperity Doubled",
        "nameLocalized": "Prosperidad doblada",
        "chinese": "八逢紫曜",
        "nature": "auspicious"
      },
      "reading": "Fire producing the wealth Earth, and the ruling star of the current period sitting with the one that ruled the last. It reads as celebration attached to money: marriage, birth, a business milestone, and property that appreciates while it is lived in."
    }
  ]
}

curl "https://roxyapi.com/api/v2/feng-shui/flying-stars/annual/2026" \
  -H "X-API-Key: YOUR_KEY"

{
  "year": 2026,
  "centerStar": 8,
  "changeoverDate": "2026-02-04",
  "palaces": [
    {
      "palace": "Southeast",
      "star": 8,
      "name": "Five Yellow",
      "nameLocalized": "Cinco Amarilla",
      "element": "Wood",
      "nature": "inauspicious",
      "enhancer": "Wood",
      "remedy": "Wood",
      "meaning": "Earth of the central palace, the one star with no trigram and no direction of its own, and the affliction every school treats as the most serious."
    }
  ]
}

curl "https://roxyapi.com/api/v2/feng-shui/flying-stars/monthly" \
  -H "X-API-Key: YOUR_KEY"

{
  "year": 2026,
  "month": 1,
  "centerStar": 8,
  "yearBranch": "wu",
  "palaces": [
    {
      "palace": "Southeast",
      "star": 8,
      "name": "Five Yellow",
      "nameLocalized": "Cinco Amarilla",
      "element": "Wood",
      "nature": "inauspicious",
      "enhancer": "Wood",
      "remedy": "Wood",
      "meaning": "Earth of the central palace, the one star with no trigram and no direction of its own, and the affliction every school treats as the most serious."
    }
  ]
}

curl "https://roxyapi.com/api/v2/feng-shui/flying-stars/stars" \
  -H "X-API-Key: YOUR_KEY"

{
  "total": 9,
  "limit": 20,
  "offset": 0,
  "stars": [
    {
      "number": 8,
      "name": "Eight White",
      "nameLocalized": "Ocho Blanca",
      "chinese": "八白",
      "pinyin": "Bā Bái",
      "element": "Wood",
      "nature": "auspicious",
      "keywords": [
        "wealth",
        "accumulation"
      ],
      "meaning": "Yang Earth in the northeastern palace, the wealth star that ruled from 2004 to 2023. It builds rather than wins: property, savings, a business that compounds, the kind of prosperity that survives a bad quarter.",
      "enhancer": "Wood",
      "remedy": "Wood",
      "palace": "Southeast",
      "period": 8,
      "trigram": {
        "number": 7,
        "english": "Mountain",
        "chinese": "艮"
      },
      "base": 8
    }
  ]
}

curl "https://roxyapi.com/api/v2/feng-shui/afflictions/2026" \
  -H "X-API-Key: YOUR_KEY"

{
  "year": 2026,
  "yearBranch": "wu",
  "changeoverDate": "2026-02-04",
  "taiSui": {
    "id": "taiSui",
    "name": "Tai Sui",
    "chinese": "太歲",
    "pinyin": "Tài Suì",
    "meaning": "The Grand Duke, who occupies the mountain of the year branch. The standing rule is to sit with your back to Tai Sui and never to face him directly.",
    "mountain": {
      "id": "wu",
      "label": "S2",
      "chinese": "午",
      "pinyin": "Wǔ",
      "direction": "Southeast",
      "yuan": "heaven",
      "polarity": "yin",
      "startDegree": 172.5,
      "endDegree": 187.5
    },
    "direction": "South",
    "animal": "horse",
    "clashingAnimal": "rat"
  },
  "suiPo": {
    "id": "suiPo",
    "name": "Sui Po",
    "chinese": "歲破",
    "pinyin": "Suì Pò",
    "meaning": "The Year Breaker, sitting exactly opposite Tai Sui because it is the mountain the year branch clashes with.",
    "mountain": {
      "id": "wu",
      "label": "S2",
      "chinese": "午",
      "pinyin": "Wǔ",
      "direction": "Southeast",
      "yuan": "heaven",
      "polarity": "yin",
      "startDegree": 172.5,
      "endDegree": 187.5
    },
    "direction": "South"
  },
  "sanSha": {
    "id": "sanSha",
    "name": "San Sha",
    "chinese": "三煞",
    "pinyin": "Sān Shà",
    "meaning": "The Three Killings, a 75 degree span opposite the elemental frame of the year. Never sit with your back to it, and facing it is safe.",
    "direction": "South",
    "frameElement": "Fire",
    "frameDirection": "South",
    "startDegree": 322.5,
    "endDegree": 37.5,
    "parts": [
      {
        "id": "zai-sha",
        "name": "Disaster Sha",
        "chinese": "災煞",
        "pinyin": "Zāi Shà",
        "meaning": "The middle component, sitting on the cardinal point itself, and the most volatile of the three. It reads as physical harm: sudden illness, accidents and injury.",
        "mountain": {
          "id": "wu",
          "label": "S2",
          "chinese": "午",
          "pinyin": "Wǔ",
          "direction": "Southeast",
          "yuan": "heaven",
          "polarity": "yin",
          "startDegree": 172.5,
          "endDegree": 187.5
        }
      }
    ]
  },
  "fiveYellow": {
    "id": "fiveYellow",
    "name": "Five Yellow",
    "chinese": "五黃",
    "pinyin": "Wǔ Huáng",
    "meaning": "The annual position of the 5, the one affliction that moves with the flying stars rather than with the year branch.",
    "palace": "South",
    "star": 8,
    "remedy": "Metal"
  }
}

curl "https://roxyapi.com/api/v2/feng-shui/bagua" \
  -H "X-API-Key: YOUR_KEY"

{
  "total": 9,
  "limit": 20,
  "offset": 0,
  "sectors": [
    {
      "id": "wealth",
      "name": "Wealth and Abundance",
      "nameLocalized": "Riqueza y abundancia",
      "number": 4,
      "palace": "Southeast",
      "direction": "Southeast",
      "element": "Wood",
      "colors": [
        "green",
        "teal"
      ],
      "trigram": {
        "number": 4,
        "chinese": "巽",
        "english": "Wind",
        "nameLocalized": "Viento",
        "pinyin": "Xùn",
        "symbol": "☴",
        "binary": "011",
        "element": "Wood",
        "elementLocalized": "Madera",
        "direction": "Southeast",
        "directionLocalized": "Sureste",
        "familyMember": "Eldest Daughter"
      },
      "earlierHeavenTrigram": {
        "number": 4,
        "chinese": "巽",
        "english": "Wind",
        "nameLocalized": "Viento",
        "pinyin": "Xùn",
        "symbol": "☴",
        "binary": "011",
        "element": "Wood",
        "elementLocalized": "Madera",
        "direction": "Southeast",
        "directionLocalized": "Sureste",
        "familyMember": "Eldest Daughter"
      },
      "focus": "Income, resources, accumulation",
      "meaning": "The southeastern palace, held by Wind, and the sector most households want working. Wind is gradual and persistent, which is the point: this reads as income that builds through repeated effort rather than as sudden gain."
    }
  ]
}

curl "https://roxyapi.com/api/v2/feng-shui/bagua/wealth" \
  -H "X-API-Key: YOUR_KEY"

{
  "id": "wealth",
  "name": "Wealth and Abundance",
  "nameLocalized": "Riqueza y abundancia",
  "number": 4,
  "palace": "Southeast",
  "direction": "Southeast",
  "element": "Wood",
  "colors": [
    "green",
    "teal"
  ],
  "trigram": {
    "number": 4,
    "chinese": "巽",
    "english": "Wind",
    "nameLocalized": "Viento",
    "pinyin": "Xùn",
    "symbol": "☴",
    "binary": "011",
    "element": "Wood",
    "elementLocalized": "Madera",
    "direction": "Southeast",
    "directionLocalized": "Sureste",
    "familyMember": "Eldest Daughter"
  },
  "earlierHeavenTrigram": {
    "number": 4,
    "chinese": "巽",
    "english": "Wind",
    "nameLocalized": "Viento",
    "pinyin": "Xùn",
    "symbol": "☴",
    "binary": "011",
    "element": "Wood",
    "elementLocalized": "Madera",
    "direction": "Southeast",
    "directionLocalized": "Sureste",
    "familyMember": "Eldest Daughter"
  },
  "focus": "Income, resources, accumulation",
  "meaning": "The southeastern palace, held by Wind, and the sector most households want working. Wind is gradual and persistent, which is the point: this reads as income that builds through repeated effort rather than as sudden gain."
}

curl "https://roxyapi.com/api/v2/feng-shui/periods" \
  -H "X-API-Key: YOUR_KEY"

{
  "total": 9,
  "cycleStartYear": 1864,
  "cycleEndYear": 2043,
  "date": "2026-08-23",
  "currentPeriod": 9,
  "periods": [
    {
      "number": 9,
      "startYear": 2024,
      "endYear": 2043,
      "startDate": "2024-02-04",
      "era": "lower",
      "eraName": "Lower Era",
      "rulingStar": 8,
      "rulingStarName": "Nine Purple",
      "rulingStarNameLocalized": "Nueve Purpura",
      "element": "Wood",
      "palace": "South",
      "trigram": {
        "number": 6,
        "english": "Fire",
        "chinese": "離"
      },
      "base": 8
    }
  ]
}