REST API + React components

Add Human Design to Your App in 5 Minutes

The only Human Design API with ready-to-use React components. Ship chart features in hours, not months.

import { Bodygraph } from '@hdhub/bodygraph-2d';   async function MyChart() { const chart = await fetch( 'https://api.humandesignhub.app/v1/bodygraph', { method: 'POST', headers: { 'x-api-key': 'YOUR_API_KEY' }, body: JSON.stringify({ datetime: '1989-03-29T16:05:00+09:00' }) } ).then(r => r.json());   return <Bodygraph data={chart} />; }
import requests payload = {"datetime": "1989-03-29T16:05:00+09:00"} # JSON response result = requests.post( "https://api.humandesignhub.app/v1/bodygraph", headers={"x-api-key": "YOUR_API_KEY"}, json=payload, ).json()
{ "type": "Manifestor", "strategy": "Inform", "authority": "Emotional", "profile": "6/2", "centers": ["Ego", "G", "Root", ...] "channels": [{"name": "Inspiration", "gates": [1, 8]}, {"name": "Awakening", "gates": [10, 20]}, ...] }
Bắt Đầu Nhanh

Thêm Human Design vào ứng dụng của bạn

Lấy biểu đồ hoàn chỉnh với một lệnh gọi API, render bằng component React — hoặc xây dựng UI riêng từ phản hồi JSON.

REST API JSON Demo component
Unique in the market

The only Human Design API with ready-to-use visualization components

Install our npm packages and render interactive bodygraph charts in your React app. No competitor offers this.

@hdhub/bodygraph-2d

Thiết kế bodygraph mà sản phẩm bạn thực sự cần

Điều chỉnh màu sắc, lớp phủ và kiểu bảng ở một nơi, xem bodygraph phù hợp sản phẩm trước khi ra mắt.

Cung cấp cho thiết kế và phát triển một bề mặt chung để phê duyệt nhanh hơn.

Dark Light Custom
Real Bodygraph Lab preview in dark theme
Classic Dark
Real Bodygraph Lab preview in light theme
Studio Light
Real Bodygraph Lab preview in custom theme
Custom Preset
@hdhub/bodygraph-3d

3D Bodygraph

Live WebGL preview running in the page.

WebGL
@hdhub/gate-timeline

Timeline

Live gate transition timeline with real component output.

Interactive
Gate Timeline
Month / Day13:25:59
Mar 28
Sat
Mar 29
Sun
Mar 30
Mon
Mar 31
Tue
Apr 1
Wed
Apr 2
Thu
Apr 3
Fri
Apr 4
Sat
Apr 5
Sun
Apr 6
Mon
Apr 7
Tue
Sun
2 Gate
5 Gate
8 Gate
11 Gate
14 Gate
17 Gate
20 Gate
Earth
9 Gate
12 Gate
15 Gate
18 Gate
21 Gate
24
27 Gate
Moon
16
19 Gate
22
25 Gate
28 Gate
31 Gate
34 Gate
37 Gate
Mercury
23 Gate
26 Gate
29 Gate
32 Gate
35 Gate
38 Gate
41
44 Gate
Venus
30 Gate
33
36 Gate
39
42 Gate
45 Gate
48 Gate
What You Can Build

Endpoints for every Human Design use case

POST /v1/bodygraph

Calculate complete bodygraphs from birth data. Type, Strategy, Authority, Profile, all 9 Centers, 64 Gates, and 36 Channels. High-precision chart calculations.

/v1/bodygraph, /v1/simple-bodygraph, /v1/circuits

Try in Playground
POST /v1/composite

Analyze relationship dynamics between two charts. Automatic composite chart generation with connection analysis and electromagnetic compatibility.

/v1/composite

Try in Playground
POST /v1/group/penta

Group Penta analysis for teams of up to 5 people. Identify team strengths, gaps, and role fit. No other API offers this endpoint.

/v1/group/penta

Try in Playground
POST /v1/transit

Real-time planetary transit data with personal chart overlay. Daily, weekly, and custom date range analysis for timing insights.

/v1/transit, /v1/transit-overlay, /v1/transit-window

Try in Playground
Sẵn sàng AI Agent

Đã sử dụng AI agent?

Chúng tôi cung cấp spec OpenAPI phù hợp gói của bạn để AI agent có thể sử dụng Human Design API chỉ với một prompt. Giao việc tích hợp cho AI.

Hãy thử với Gói Miễn phí trước.

Ví dụ Prompt Đưa URL spec và token cho agent của bạn
Build an interface that uses
https://humandesignhub.app/api/v1/openapi.json

token: hd_live_xxxxx

After it is done, explain what APIs
are available.
OpenAPI spec Tham chiếu JSON phù hợp gói của bạn
Có kèm khóa Sao chép prompt với khóa API thật
Giải thích API Agent giải thích các endpoint có thể dùng
Chỉ có trên Human Design API

Phân tích động lực nhóm mà không API nào khác có

Group Penta tính toán cách tối đa 5 cá nhân kết hợp thành một thực thể nhóm. Xác định điểm mạnh, khoảng trống và phân bổ vai trò tối ưu. Endpoint này không tồn tại ở nơi nào khác.

POST /v1/group/penta Một endpoint. Phân tích nhóm hoàn chỉnh.
Thử Group Penta

Điều gì xảy ra khi bạn gọi API

Một dòng code. Hàng nghìn phép tính.

Phía sau hậu trường
calculate_planetary_position(jd, "Sun")Vị trí hành tinh độ chính xác cao
|
longitude % 5.625 → Gate 41, Line 3Ánh xạ kinh độ sang cổng và đường
|
gate_to_center[41] → "Root"Gán cổng cho trung tâm năng lượng
|
channel_check([41,30]) → definedKiểm tra kết nối kênh
|
... ×13 planets × 2 calculations ...Lặp lại cho cả 13 thiên thể, hai lần
|
determine_type(defined_centers) → "Generator"Suy ra loại, quyền, hồ sơ...
200+ phép tính mỗi biểu đồ
Bạn viết gì
const chart = await hd.getChart({
  datetime: '1987-03-23T09:00+09:00'
});
// That's it. Full chart.
200 OK Biểu đồ hoàn chỉnh với loại, quyền, trung tâm, kênh, cổng, đường, hồ sơ
Pricing

Start free, scale as you grow

Human Design Hub

Bảng giá

Bảng giá
FAQ

Frequently Asked Questions

What is the Human Design API? +

The Human Design API is a REST API that calculates Human Design bodygraph charts from birth data. It performs high-precision astronomical calculations and returns chart components including Type, Strategy, Authority, Profile, Centers, Gates, and Channels.

How do I calculate a Human Design chart programmatically? +

Send a POST request to /v1/simple-bodygraph with datetime in ISO 8601 format in the JSON body. The API returns chart data including Type, Profile, Centers, Gates, and Channels. Get your free API key at humandesignhub.app/developer.

Is there a free Human Design API? +

Yes. The Human Design API offers a free tier with 100 API credits per month and 5 requests per minute. The free tier includes the Simple Bodygraph endpoint for basic chart calculations.

What is a bodygraph and how does the API generate one? +

A bodygraph is the visual representation of a Human Design chart, showing 9 Centers, 64 Gates, and 36 Channels. The API calculates planetary positions at birth, maps them to the I Ching hexagram system, and returns structured data you can use to render bodygraph visualizations.

Can I build a Human Design calculator with this API? +

Absolutely. The API handles all astronomical calculations — you provide birth data (date, time, place) and receive a complete chart. Use the free tier for prototyping, then upgrade for full bodygraph data, composite charts, and interactive visualization components.

What programming languages work with the Human Design API? +

Any language that can make HTTP requests works with the API. We provide examples in cURL, JavaScript, and Python. The API returns JSON, making it easy to integrate with React, Vue, Angular, Node.js, Django, Flask, or any other framework.

How accurate is the Human Design API? +

The API uses a professional-grade astronomical calculation pipeline. Planetary positions are calculated to arc-second precision, ensuring highly accurate bodygraph calculations for any birth data from 1900 to 2100.

What is Group Penta analysis? +

Group Penta is a Human Design framework for analyzing team dynamics for groups of up to 5 people. Our API is the only one in the market that offers a Group Penta endpoint, making it possible to build team-building, HR tech, and group coaching applications.

Can I use the npm components without the API? +

The npm packages (@hdhub/bodygraph-2d, @hdhub/bodygraph-3d, @hdhub/gate-timeline) require chart data from the API to render. They are visualization components that consume the JSON response from any bodygraph endpoint. You need an active API subscription with SDK access (Standard plan or above).

How does the Human Design API compare to alternatives? +

We offer the most comprehensive Human Design API — the lowest paid entry at $9.99/month, the only meaningful free tier (100 credits/month), the only provider with React npm components for bodygraph visualization, and the only one with a Group Penta endpoint.

Start building with Human Design data today

Start with 100 free credits.

Get Free API Key