Lo Shu Grid

Builds a Lo Shu 3x3 numerology grid from a birth date. Returns the grid with digit counts, present/missing/repeated numbers, plane analysis (thought/will/action), and per-number trait interpretation.

Endpoint

POST /v1/numerology/lo-shu

Request parameters

Field	Type	Required	Description
date	string (date)	Yes	Birth date YYYY-MM-DD (BirthInput date)

Example request

curl

curl -X POST "https://api.asterwise.com/v1/numerology/lo-shu" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1985-11-12"}'

Python

import asterwise
from asterwise.api.numerology_api import NumerologyApi
from asterwise.models.lo_shu_request import LoShuRequest

configuration = asterwise.Configuration(
    host="https://api.asterwise.com",
    access_token="YOUR_API_KEY",
)

request = LoShuRequest(
    date="1985-11-12",
)

with asterwise.ApiClient(configuration) as client:
    api = NumerologyApi(client)
    result = api.lo_shu(lo_shu_request=request)
    print(result)

TypeScript

import { createClient, createConfig, loShu } from 'asterwise';

const client = createClient(createConfig({
  baseUrl: 'https://api.asterwise.com',
  headers: { Authorization: 'Bearer YOUR_API_KEY' },
}));

const result = await loShu({
  client,
  body: {
      "date": "1985-11-12"
  },
});

console.log(result.data);

Example response

{
  "success": true,
  "message": "success",
  "data": {
    "birth_date": "1985-11-12",
    "grid": [
      [
        0,
        1,
        "... and 1 more item"
      ],
      [
        0,
        1,
        "... and 1 more item"
      ],
      "... and 1 more item"
    ],
    "present_numbers": [
      1,
      2,
      "... and 3 more items"
    ],
    "missing_numbers": [
      3,
      4,
      "... and 2 more items"
    ],
    "repeated_numbers": [
      1
    ],
    "plane_analysis": {
      "thought_plane": {
        "numbers": [
          3,
          6,
          "... and 1 more item"
        ],
        "description": "Mental/intellectual capacity",
        "complete": false
      },
      "will_plane": {
        "numbers": [
          2,
          5,
          "... and 1 more item"
        ],
        "description": "Emotional strength and will",
        "complete": true
      },
      "action_plane": {
        "numbers": [
          1,
          4,
          "... and 1 more item"
        ],
        "description": "Physical energy and action",
        "complete": false
      },
      "golden_yod": {
        "numbers": [
          3,
          5,
          "... and 1 more item"
        ],
        "description": "Spiritual diagonal",
        "complete": false
      },
      "silver_yod": {
        "numbers": [
          1,
          5,
          "... and 1 more item"
        ],
        "description": "Material diagonal",
        "complete": true
      }
    },
    "number_analysis": {
      "1": {
        "count": 4,
        "plane": "mental",
        "trait": "Communication & confidence",
        "status": "strong",
        "note": "Highly expressive and confident."
      },
      "2": {
        "count": 1,
        "plane": "mental",
        "trait": "Intuition & sensitivity",
        "status": "present",
        "note": "Intuition & sensitivity"
      },
      "3": {
        "count": 0,
        "plane": "mental",
        "trait": "Memory & intellect",
        "status": "missing",
        "note": "Memory issues; mental blocks."
      },
      "4": {
        "count": 0,
        "plane": "physical",
        "trait": "Practicality & hard work",
        "status": "missing",
        "note": "Lack of patience; avoids manual work."
      },
      "5": {
        "count": 1,
        "plane": "physical",
        "trait": "Emotional balance (centre)",
        "status": "present",
        "note": "Emotional balance (centre)"
      },
      "6": {
        "count": 0,
        "plane": "physical",
        "trait": "Creativity & vision",
        "status": "missing",
        "note": "Difficulty visualising goals."
      },
      "7": {
        "count": 0,
        "plane": "spiritual",
        "trait": "Sacrifice & learning",
        "status": "missing",
        "note": "Fear of loss; attachment issues."
      },
      "8": {
        "count": 1,
        "plane": "spiritual",
        "trait": "Wisdom & organisation",
        "status": "present",
        "note": "Wisdom & organisation"
      },
      "9": {
        "count": 1,
        "plane": "spiritual",
        "trait": "Ambition & idealism",
        "status": "present",
        "note": "Ambition & idealism"
      }
    }
  }
}

Response fields

Field	Type	Description
success	boolean	True if the request succeeded
message	string	Human-readable status message
data	object
data.birth_date	string
data.grid	array[array[integer]]
data.present_numbers	array[integer]
data.missing_numbers	array[integer]
data.repeated_numbers	array[integer]
data.plane_analysis	object
data.number_analysis	object

Errors

Code	Description	Reference
authentication_failed	Missing or invalid API key.	authentication_failed
ephemeris_unavailable	Upstream ephemeris service error.	ephemeris_unavailable
insufficient_tier	API key tier does not include this endpoint.	insufficient_tier
internal_error	Unexpected server error.	internal_error
ip_rate_limit_exceeded	Too many requests in a short window.	ip_rate_limit_exceeded
payload_too_large	Request body exceeds the size limit.	payload_too_large
resource_not_found	Referenced resource was not found.	resource_not_found
validation_error	Request body failed schema validation.	validation_error

Related endpoints

• Chaldean Numerology Profile