v1 · stable · 46 endpoints

Query the time.
Know the moment.

People have a temporal location. TimeQL maps it to coordinates, cross-validates across calculation systems, and returns the easiest route — as typed JSON.

Read the docs
46 Endpoints
8 Surface groups
1,000 Free credits / mo
~189ms Median latency
timeql · query → result
$ timeql query "When should we launch the rebrand?" resolving qimen/matrix, horoscope/transits, bazi/fortune scanning 30 day window · 3 systems best_slots[ #1 2026-04-15 AM · convergence 3 / 3 · score 94 #2 2026-04-22 PM · convergence 2 / 3 · score 78 #3 2026-05-01 AM · convergence 2 / 3 · score 71 ] 3 systems · 30 credits · 189 ms
01 · Overview

A query language
for symbolic time.

You describe what you need. TimeQL compiles it into one or more calculation systems, returns typed JSON with symbolic semantics, and leaves narrative or action to your application.

Input datetime + location, birth_date + optional name, or free-text dream material L0
Resolve compile your question into one or more calculation systems L1 — L2
Return typed JSON objects with symbolic semantics and support signals L3 — L5
Interpret narrative or action is your application's job — or use UN as the canonical L6 layer L6
02 · API surface

Start with the question,
not the tradition.

46 public routes across 8 surface groups. Profiles, timing, relations, directions, naming, latent symbolic, and observation feedback — all share one canonical shape. All endpoints →

S System
Discovery & schema
Active TimeQL contract, capability catalog, and schema surfaces.
GET/v1/updates
GET/v1/capabilities
GET/v1/endpoints
GET/v1/taxonomy
GET/v1/openapi-custom
GET/v1/health
P Profiles & charts
Birth, system, framework
Resolve a birth event or framework into a stable symbolic profile.
POST/v1/horoscope/natal
POST/v1/bazi
POST/v1/tekitenzui
POST/v1/sanmeigaku
POST/v1/jyotish
POST/v1/ziweidoushu
POST/v1/sukuyo
POST/v1/mayan
POST/v1/numerology
POST/v1/kanshi
POST/v2/body
C Compatibility
Two or more profiles
Compare profiles as a structured relation model.
POST/v1/horoscope/synastry
POST/v1/horoscope/triple_synastry
POST/v1/horoscope/composite
POST/v1/bazi/compatibility
POST/v1/sanmeigaku/compatibility
POST/v1/kyusei/compatibility
POST/v1/sukuyo/compatibility
POST/v1/sukuyo/compatibility/search
POST/v1/mayan/compatibility
POST/v1/numerology/compatibility
POST/v2/relation
T Timing & moment
Activation windows
Resolve a timestamp into temporal state and activation windows.
POST/v1/horoscope/transits
POST/v1/horoscope/transit_events
POST/v1/horoscope/event_chart
POST/v1/horoscope/progressions
POST/v1/horoscope/return_chart
POST/v1/horoscope/election
POST/v1/jyotish/gochara
POST/v1/bazi/fortune
POST/v1/sukuyo/fortune
POST/v1/liuren
POST/v2/time
D Directions & environment
Spatial configuration
Rank directions, matrix states, and environment surfaces.
POST/v1/kyusei
POST/v1/kyusei/directions
POST/v1/kyusei/guidance
POST/v1/qimen
POST/v1/qimen/matrix
POST/v1/fengshui
POST/v1/tekitenzui_qimen
POST/v1/tekitenzui_fengshui
N Naming
Score & suggest
Evaluate candidate names and return scoring or ranked suggestions.
POST/v1/seimei
POST/v1/seimei/suggest
L Latent symbolic
Free-text resolution
Resolve dream text into compiled latent states and concept families.
POST/v1/dream
O Observation
Post-compute feedback
Attach context, inner signals, and outcomes to a prior query_id.
POST/v1/feedback/context
POST/v1/signals/inner
POST/v1/feedback/outcome
03 · Architecture

Structure below the line.
Interpretation above.

TimeQL computes L0 – L5 and returns raw compute plus symbolic semantics. Your AI or application interprets above the line.

L0 Input datetime + location, or birth_date + name datetime, location, name
L1 Conversion calendar normalization, stems & branches, positions stems, branches, positions
L2 Cycles dasha, daiun, transits, progressions dasha, daiun, transits
L3 Symbols elements, archetypes, keywords, polarity elements, archetypes
L4 Relations aspects, compatibility, convergence aspects, convergence
L5 Progression timeline, ranking, scoring timeline, ranked windows
TimeQL boundary
L6 Interpretation your AI, your app — or UN as the canonical reference narrative, action
04 · Onboarding

Three steps to your
first response.

Sign up, pick a plan, get a key. No credit card required for the sandbox.

step 01
Sign up
One click with Google or GitHub. Your TimeQL workspace is created instantly.
~ 5 sec
step 02
Pick a plan
Free Sandbox includes 1,000 credits per month. Upgrade later when you ship.
Free Sandbox · JPY 0 / mo 1,000 cr
step 03
Get your API key
Send REST + JSON. Authenticate with a single bearer token. SDKs follow.
sk-tq-••••••••••
05 · Pricing

Credit-based billing,
by complexity.

Monthly credit allowance. Endpoints are billed by class, not per-call. All prices in JPY (tax included).

Free Sandbox
¥0/ mo
Testing & personal use
  • 1,000 credits / mo
  • 5 RPM
  • All endpoints
  • Community support
Builder
¥7,980/ mo
Small apps & indie dev
  • 15,000 credits / mo
  • 25 RPM
  • Email support
  • Auto top-up
Scale
¥79,800/ mo
Production workloads
  • 300,000 credits / mo
  • 150 RPM
  • Dedicated support
  • Auto top-up

Enterprise

SLA 99.95% · Custom RPM · Custom features · Dedicated support · White-label

Contact sales →
Class Credits Endpoints Family
Meta 0 /v1/health · /v1/capabilities · /v1/updates · /v1/taxonomy · /v1/endpoints System
Light 1 /v1/sukuyo · /v1/sukuyo/compatibility · /v1/sukuyo/fortune Moment
Core 5 /v1/dream · /v1/kanshi · /v1/kyusei · /v1/ziweidoushu · /v1/liuren · /v1/sanmeigaku · /v1/horoscope/return_chart · /v1/sukuyo/compatibility/search · /v1/mayan · /v1/mayan/compatibility · /v1/numerology · /v1/numerology/compatibility Person · Relation · Moment
Standard 10 /v1/bazi · /v1/horoscope/natal · /v1/horoscope/transits · /v1/horoscope/synastry · /v1/horoscope/composite · /v1/horoscope/progressions · /v1/horoscope/election · /v1/seimei Person · Relation · Search
Intensive 25 /v1/bazi/compatibility · /v1/bazi/fortune · /v1/qimen · /v1/qimen/matrix · /v1/kyusei/guidance Relation · Search · Moment
Deep 100 /v1/tekitenzui · /v1/jyotish · /v2/body · /v2/time · /v2/relation Person · Moment · Relation

Credit calculator

Estimate monthly usage to find the right plan.

Light 1 cr
0
Core 5 cr
0
Standard 10 cr
0
Intensive 25 cr
0
Deep 100 cr
0
0credits / month
Free Sandbox
06 · Method

Method, trust,
and control.

TimeQL is the compute layer. What it returns is auditable, typed, and explicit about its limits.

01
Not a prose generator
TimeQL returns typed JSON, never narrative. Interpretation stays in your application.
02
Not one tradition
Multiple calculation systems cross-validate. No single forced answer.
03
Not a black box
Every score has explainable support signals. Convergence and divergence are first-class.
04
Not a replacement
Your product logic stays yours. TimeQL provides typed primitives — you decide what to do with them.
OpenAPI 3.1 Changelog Methodology
Free Sandbox · 1,000 credits / mo

Get started

Sign in to receive your API key.

公開審査用のサンプルデータでダッシュボード全体を確認できます。