POST/v1/numerology/lo-shu

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.

Request parameters

daterequired

string (date)

Birth date YYYY-MM-DD (BirthInput date)

Response fields

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

authentication_failed

Missing or invalid API key.

ephemeris_unavailable

Upstream ephemeris service error.

insufficient_tier

API key tier does not include this endpoint.

internal_error

Unexpected server error.

ip_rate_limit_exceeded

Too many requests in a short window.

payload_too_large

Request body exceeds the size limit.

resource_not_found

Referenced resource was not found.

validation_error

Request body failed schema validation.

Related endpoints

• Chaldean Numerology Profile

Request

POST·application/json

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);

Response

200 OK·application/jsonsigned

{
  "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"
      }
    }
  }
}