AOV Fortune-Telling & Divination API

Use

https://aov.cc/api/v1

as the base URL. All interfaces return a unified JSON format:

json

{
  "ok": true,
  "data": {},
  "meta": {
    "service": "aov.cc",
    "version": "v1"
  }
}

Error response:

json

{
  "ok": false,
  "error": {
    "code": "BAD_REQUEST",
    "message": "Error description"
  },
  "meta": {
    "service": "aov.cc",
    "version": "v1"
  }
}

Workflow

First read
```
GET /manifest
```
or
```
GET /openapi.json
```
to confirm interface capabilities.
When only structured data is needed, call the calculation interfaces such as
```
/calculate
```
or
```
/divination/{method}
```
.
When AI interpretation prompts are needed, prioritize calling the corresponding
```
/prompt
```
one-stop interface, and directly read
```
data.result
```
and
```
data.prompt
```
; divination interfaces will also return
```
data.summary
```
.
When presenting results to users, note that this is calculation and prompt data, and does not replace professional advice such as medical, legal, or investment advice.

Common Interfaces

```
GET /health
```
: Health check.
```
GET /manifest
```
: API metadata, OpenAPI URL and skill URL.
```
GET /openapi.json
```
: Complete OpenAPI JSON.
```
POST /bazi/calculate
```
: Bazi Calculation.
```
POST /bazi/prompt
```
: Bazi Calculation and generate structured AI interpretation prompt.
```
POST /ziwei/calculate
```
: Zi Wei Dou Shu Calculation.
```
POST /ziwei/prompt
```
: Zi Wei Dou Shu Calculation and generate structured AI interpretation prompt.
```
POST /divination/liuyao
```
: Liu Yao Divination.
```
POST /divination/liuyao/prompt
```
: Liu Yao Divination and generate structured AI interpretation prompt.
```
POST /divination/meihua
```
: Meihua Yishu Divination.
```
POST /divination/meihua/prompt
```
: Meihua Yishu Divination and generate structured AI interpretation prompt.
```
POST /divination/xiaoliuren
```
: Xiao Liuren Divination.
```
POST /divination/xiaoliuren/prompt
```
: Xiao Liuren Divination and generate structured AI interpretation prompt.
```
POST /divination/qimen
```
: Qimen Dunjia Calculation.
```
POST /divination/qimen/prompt
```
: Qimen Dunjia Calculation and generate structured AI interpretation prompt.
```
POST /divination/liuren
```
: Da Liuren Calculation.
```
POST /divination/liuren/prompt
```
: Da Liuren Calculation and generate structured AI interpretation prompt.
```
POST /divination/tarot
```
: Tarot Card Drawing.
```
POST /divination/tarot/prompt
```
: Tarot Card Drawing and generate structured AI interpretation prompt.
```
POST /divination/ssgw
```
: SSGW Spirit Lot Drawing.
```
POST /divination/ssgw/prompt
```
: SSGW Spirit Lot Drawing and generate structured AI interpretation prompt.
```
POST /divination/almanac
```
: Chinese Almanac Date Selection.
```
POST /divination/almanac/prompt
```
: Chinese Almanac Date Selection and generate structured AI interpretation prompt.
```
POST /divination/lenormand
```
: Lenormand Card Drawing.
```
POST /divination/lenormand/prompt
```
: Lenormand Card Drawing and generate structured AI interpretation prompt.
```
POST /divination/astrolabe
```
: Astrolabe Generation.
```
POST /divination/astrolabe/prompt
```
: Astrolabe Generation and generate structured AI interpretation prompt.

Request Examples

Bazi Calculation:

bash

curl -X POST https://aov.cc/api/v1/bazi/calculate \
  -H "Content-Type: application/json" \
  -d '{"gender":"male","year":1990,"month":5,"day":15,"timeIndex":1,"dateType":"solar"}'

Zi Wei Dou Shu Calculation:

bash

curl -X POST https://aov.cc/api/v1/ziwei/calculate \
  -H "Content-Type: application/json" \
  -d '{"name":"测试","gender":"female","dateType":"solar","year":"1992","month":"8","day":"21","timeIndex":4}'

Bazi Calculation and Generate Prompt:

bash

curl -X POST https://aov.cc/api/v1/bazi/prompt \
  -H "Content-Type: application/json" \
  -d '{"gender":"male","year":1990,"month":5,"day":15,"timeIndex":1,"dateType":"solar","question":"我适合创业还是上班？","promptTopic":"career"}'

Zi Wei Dou Shu Calculation and Generate Prompt:

bash

curl -X POST https://aov.cc/api/v1/ziwei/prompt \
  -H "Content-Type: application/json" \
  -d '{"name":"测试","gender":"female","dateType":"solar","year":"1992","month":"8","day":"21","timeIndex":4,"question":"我的感情关系要注意什么？","promptTopic":"relationship","promptScope":"origin"}'

Tarot Card Drawing:

bash

curl -X POST https://aov.cc/api/v1/divination/tarot \
  -H "Content-Type: application/json" \
  -d '{"spreadType":"single"}'

Tarot Card Drawing and Generate Prompt:

bash

curl -X POST https://aov.cc/api/v1/divination/tarot/prompt \
  -H "Content-Type: application/json" \
  -d '{"spreadType":"single","question":"我近期事业应该注意什么？"}'

Chinese Almanac Date Selection:

bash

curl -X POST https://aov.cc/api/v1/divination/almanac \
  -H "Content-Type: application/json" \
  -d '{"topic":"move","startDate":"2026-06-01","endDate":"2026-06-05","participants":[{"id":"self","name":"本人","gender":"男","year":1990,"month":1,"day":1,"timeIndex":12,"dateType":"solar"}]}'

Astrolabe Generation:

bash

curl -X POST https://aov.cc/api/v1/divination/astrolabe \
  -H "Content-Type: application/json" \
  -d '{"name":"本人","gender":"女","year":1995,"month":5,"day":20,"hour":12,"minute":30,"latitude":39.9042,"longitude":116.4074,"timezone":8,"locationName":"北京"}'

Parameter Conventions

General Parameters:

```
gender
```
: Use
```
male
```
or
```
female
```
for Bazi and Zi Wei Dou Shu; use
```
男
```
,
```
女
```
or empty string for Chinese Almanac date selection and astrolabe.
```
dateType
```
: Use
```
solar
```
(solar calendar) or
```
lunar
```
(lunar calendar).
```
timeIndex
```
: Range from
```
0
```
to
```
12
```
, where
```
0
```
is early Zi Shi,
```
1
```
is Chou Shi, ...,
```
11
```
is Hai Shi,
```
12
```
is late Zi Shi.
```
isLeapMonth
```
: Boolean value, only valid for lunar calendar.
```
useTrueSolarTime
```
: Boolean value, enable true solar time correction. For Bazi and Zi Wei Dou Shu,
```
birthHour
```
,
```
birthMinute
```
,
```
birthLongitude
```
are required after enabling, and
```
timeIndex
```
will be automatically converted by the program; for astrolabe, correction is done using
```
hour
```
,
```
minute
```
and
```
longitude
```
after enabling.

Supported

promptTopic

for Bazi:

general

(Comprehensive),

recent

(Recent),

career

(Career),

job-change

(Job Change),

startup-partnership

(Startup Partnership),

investment-partnership

(Investment Partnership),

wealth

(Wealth),

marriage

(Marriage & Love),

relationship-push

(Relationship Promotion),

relationship-decision

(Relationship Choice),

reconciliation-decision

(Reconciliation Judgment),

children

(Children),

family

(Family),

home-move

(House Moving & Property Purchase),

settle-relocate

(Settle Down & Relocate),

social

(Interpersonal Cooperation),

emotion

(Emotion & Psychology),

health

(Health),

parents

(Parents),

study

(Study),

study-advance

(Certification & Further Study),

exam-landing

(Exam Success),

growth

(Growth Direction),

talent

(Talent Traits).

Supported

promptTopic

for Zi Wei Dou Shu:

destiny

(Fate Chart),

relationship

(Relationship),

relationship-push

(Relationship Promotion),

relationship-decision

(Relationship Choice),

career-wealth

(Career & Wealth),

job-change

(Job Change),

startup-partnership

(Startup Partnership),

investment-partnership

(Investment Partnership),

recent

(Recent Trend),

family

(Relatives & Family),

home-move

(House Moving & Property Purchase),

settle-relocate

(Settle Down & Relocate),

social

(Interpersonal Cooperation),

emotion

(Emotion & Psychology),

health

(Health Care),

study

(Study & Growth),

study-advance

(Certification & Further Study),

exam-landing

(Exam Success),

growth

(Growth Direction),

talent

(Talent Traits),

reconciliation-decision

(Reconciliation Judgment),

life

(Life Analysis),

chat

(Free Chat).

Supported

promptScope

for Zi Wei Dou Shu:

origin

(Native Chart),

decadal

(Decade Luck),

yearly

(Annual Luck),

monthly

(Monthly Luck),

daily

(Daily Luck),

hourly

(Hourly Luck),

age

(Age).

Supported

promptMode

framework

(Built-in complete framework, default),

custom

(Answer freely around user's question without framework).

General Parameters for Divination:

```
customDate
```
: ISO 8601 time string with time zone, e.g.,
```
2025-01-01T08:00:00+08:00
```
; current time will be used if not provided.
```
question
```
: Required field for all
```
/prompt
```
interfaces, optional for Chinese Almanac date selection
```
/prompt
```
.
```
supplementaryInfo
```
: Object type, supplementary information for divination.

Method-Specific Parameters for Divination:

Meihua Yishu
```
method
```
:
```
time
```
(Divination by time),
```
number
```
(Divination by number),
```
random
```
(Random divination),
```
external
```
(Divination by external omens). When
```
method
```
is
```
number
```
,
```
number
```
(positive integer) is required; when
```
method
```
is
```
external
```
,
```
externalOmens
```
is required with at least two items mapping external omens, and
```
count
```
as the number of moving lines, e.g.,
```
{"direction":"南","object":"火电文书","count":3}
```
.
Xiao Liuren
```
xiaoliurenMethod
```
:
```
time
```
,
```
number
```
,
```
random
```
. When
```
number
```
is selected,
```
xiaoliurenNumber
```
(positive integer) is required.
Tarot
```
spreadType
```
:
```
single
```
(Single Card Guidance),
```
three
```
(Timeline),
```
love
```
(Love),
```
career
```
(Career),
```
decision
```
(Decision).
Liu Yao
```
liuyaoTemplate
```
:
```
general
```
(General),
```
ganqing
```
(Relationship),
```
shiye
```
(Career),
```
caifu
```
(Wealth),
```
guaishen
```
(Supernatural).
Da Liuren
```
liurenTemplate
```
:
```
general
```
(General),
```
ganqing
```
(Relationship),
```
shiye
```
(Career),
```
caifu
```
(Wealth).
Chinese Almanac Date Selection
```
topic
```
:
```
marriage
```
(Wedding),
```
move
```
(House Moving),
```
opening
```
(Business Opening),
```
contract
```
(Contract Signing),
```
travel
```
(Travel),
```
medical
```
(Medical Treatment),
```
study
```
(Study),
```
custom
```
(Custom).
Chinese Almanac Date Selection
```
startDate
```
,
```
endDate
```
: Date range strings.
```
participants
```
: Array of participants, each including
```
id
```
,
```
name
```
,
```
gender
```
,
```
year
```
,
```
month
```
,
```
day
```
,
```
timeIndex
```
,
```
dateType
```
,
```
isLeapMonth
```
.

Lenormand

spreadType

single

three

relationship

decision

nine

Astrolabe
```
year
```
,
```
month
```
,
```
day
```
,
```
hour
```
,
```
minute
```
: Birth time.
```
latitude
```
,
```
longitude
```
: Latitude and longitude.
```
timezone
```
: Time zone offset.
```
locationName
```
: Location name.
```
useTrueSolarTime
```
can be passed to enable true solar time correction; prompt interfaces can pass
```
astrolabeTopic
```
and
```
astrolabeScopeText
```
to write analysis objects such as native chart, annual luck, monthly luck or daily luck.

aov-mingyu-api

NPX Install

Tags

SKILL.md Content (Chinese)

AOV Fortune-Telling & Divination API

Workflow

Common Interfaces

Request Examples

Parameter Conventions