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 over the eight lines of the square (rows mental/emotional/practical, columns thought/will/action, two diagonals), and per-number trait interpretation. In number_analysis, plane is the legacy v1 grouping (1-3 mental, 4-6 physical, 7-9 spiritual) and lo_shu_plane is the number's row of the square (mental 4-9-2, emotional 3-5-7, practical 8-1-6).

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

The eight lines of the Lo Shu square. Rows: mental_plane 4-9-2, emotional_plane 3-5-7, practical_plane 8-1-6. Columns: thought_plane 4-3-8, will_plane 9-5-1, action_plane 2-7-6. Diagonals: diagonal_4_5_6, diagonal_2_5_8. golden_yod (3-5-7) and silver_yod (1-5-9) are deprecated duplicates of emotional_plane and will_plane, kept for v1 compatibility.

data.number_analysis

object

Errors

api_key_invalid

Invalid API key format.

api_key_missing

API key is missing. Include it in the Authorization header as 'Bearer YOUR_KEY'.

api_key_not_found

The provided API key was not found. Verify the key in your Asterwise dashboard.

api_key_revoked

This API key has been revoked.

burst_limit_exceeded

Too many requests per minute. Please slow down.

internal_error

Something went wrong on our end. Please try again, or contact [email protected] if the problem persists. Include your request_id when contacting support.

ip_rate_limit_exceeded

Too many requests from this IP address. Please slow down.

monthly_usage_limit_exceeded

Monthly API call limit reached. Upgrade your plan to continue.

payload_too_large

Request body exceeds maximum allowed size of 64KB.

subscription_expired

Your subscription has expired. Please renew at asterwise.com/dashboard to continue.

validation_error

The request couldn't be processed. See the 'details' field for specific field-level issues.

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": {
      "mental_plane": {
        "numbers": [
          4,
          9,
          "... and 1 more item"
        ],
        "description": "Top row 4-9-2: thinking, planning and memory",
        "complete": false
      },
      "emotional_plane": {
        "numbers": [
          3,
          5,
          "... and 1 more item"
        ],
        "description": "Middle row 3-5-7: feelings, sensitivity and inner balance",
        "complete": false
      },
      "practical_plane": {
        "numbers": [
          8,
          1,
          "... and 1 more item"
        ],
        "description": "Bottom row 8-1-6: practical, material and physical life",
        "complete": false
      },
      "thought_plane": {
        "numbers": [
          4,
          3,
          "... and 1 more item"
        ],
        "description": "Left column 4-3-8: ideas and the planning of action",
        "complete": false
      },
      "will_plane": {
        "numbers": [
          9,
          5,
          "... and 1 more item"
        ],
        "description": "Centre column 9-5-1: willpower and determination",
        "complete": true
      },
      "action_plane": {
        "numbers": [
          2,
          7,
          "... and 1 more item"
        ],
        "description": "Right column 2-7-6: carrying plans into action",
        "complete": false
      },
      "diagonal_4_5_6": {
        "numbers": [
          4,
          5,
          "... and 1 more item"
        ],
        "description": "Diagonal 4-5-6 (top-left to bottom-right)",
        "complete": false
      },
      "diagonal_2_5_8": {
        "numbers": [
          2,
          5,
          "... and 1 more item"
        ],
        "description": "Diagonal 2-5-8 (top-right to bottom-left)",
        "complete": true
      },
      "golden_yod": {
        "numbers": [
          3,
          5,
          "... and 1 more item"
        ],
        "description": "Deprecated: same line as emotional_plane (middle row 3-5-7), not a diagonal. Use emotional_plane.",
        "complete": false
      },
      "silver_yod": {
        "numbers": [
          1,
          5,
          "... and 1 more item"
        ],
        "description": "Deprecated: same line as will_plane (centre column 9-5-1), not a diagonal. Use will_plane.",
        "complete": true
      }
    },
    "number_analysis": {
      "1": {
        "count": 4,
        "plane": "mental",
        "lo_shu_plane": "practical",
        "trait": "Communication & confidence",
        "status": "strong",
        "note": "Highly expressive and confident."
      },
      "2": {
        "count": 1,
        "plane": "mental",
        "lo_shu_plane": "mental",
        "trait": "Intuition & sensitivity",
        "status": "present",
        "note": "Intuition & sensitivity"
      },
      "3": {
        "count": 0,
        "plane": "mental",
        "lo_shu_plane": "emotional",
        "trait": "Memory & intellect",
        "status": "missing",
        "note": "Memory issues; mental blocks."
      },
      "4": {
        "count": 0,
        "plane": "physical",
        "lo_shu_plane": "mental",
        "trait": "Practicality & hard work",
        "status": "missing",
        "note": "Lack of patience; avoids manual work."
      },
      "5": {
        "count": 1,
        "plane": "physical",
        "lo_shu_plane": "emotional",
        "trait": "Emotional balance (centre)",
        "status": "present",
        "note": "Emotional balance (centre)"
      },
      "6": {
        "count": 0,
        "plane": "physical",
        "lo_shu_plane": "practical",
        "trait": "Creativity & vision",
        "status": "missing",
        "note": "Difficulty visualising goals."
      },
      "7": {
        "count": 0,
        "plane": "spiritual",
        "lo_shu_plane": "emotional",
        "trait": "Sacrifice & learning",
        "status": "missing",
        "note": "Fear of loss; attachment issues."
      },
      "8": {
        "count": 1,
        "plane": "spiritual",
        "lo_shu_plane": "practical",
        "trait": "Wisdom & organisation",
        "status": "present",
        "note": "Wisdom & organisation"
      },
      "9": {
        "count": 1,
        "plane": "spiritual",
        "lo_shu_plane": "mental",
        "trait": "Ambition & idealism",
        "status": "present",
        "note": "Ambition & idealism"
      }
    }
  }
}