# Forever Better / Wellnizz Genetics Ancestry API

> Forever Better / Wellnizz Genetics Ancestry API is a paid API for AI agents from api.foreverbetter.xyz, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-13).

Generates ancestry proportions and geographic map data from an imported genetics source owned by the paying wallet.

## Facts

- Endpoint: POST https://api.foreverbetter.xyz/genetics/ancestry
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forever-better-wellnizz-genetics-ancestry-api-6cde5e43
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZllV6MBLGxrGozUfRARnu

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability forever-better-wellnizz-genetics-ancestry-api-6cde5e43 -d '<json body>'
```

Example prompt: Using my imported genetics source (source ID: src_abc123), generate an ancestry breakdown at sub-population resolution so I can see my detailed ethnic proportions and where my ancestors came from geographically.

## When to prefer this

Use this endpoint when you have already imported a genetics source into the Wellnizz/Forever Better platform and need to derive ancestry composition and geographic map data from it. Prefer this over generic ancestry lookup services when the user's data is already in the platform's private workspace and wallet-gated. Choose the appropriate resolution (continental for broad overview, regional for country-level, sub-population for fine-grained ethnic group detail).

## Known failure modes

- Invalid or unrecognized source_id returns an error indicating the source was not found or does not belong to the paying wallet
- Source not yet processed or still importing returns a pending/not-ready error
- Invalid resolution enum value returns a validation error
- Payment wallet mismatch or unauthorized access returns an auth/ownership error
- Genetics source lacks sufficient data for the requested resolution level

## How this service works

Generate ancestry proportions and map data from a genetics source owned by the paying wallet.

## Output

Returns ancestry proportion data and geographic map data derived from the specified genetics source, broken down by the requested resolution (continental, regional, or sub-population). Includes percentage shares per ancestry group and associated geographic mapping information.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "source_id"
     ],
     "properties": {
      "source_id": {
       "type": "string",
       "description": "Genetics source ID returned by an import."
      },
      "resolution": {
       "enum": [
        "continental",
        "regional",
        "sub_population"
       ],
       "type": "string",
       "description": "Requested ancestry resolution."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "complete",
  "ancestry": [],
  "geographic_map": {
   "regions": []
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forever-better-wellnizz-genetics-ancestry-api-6cde5e43/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.foreverbetter.xyz](https://www.zero.xyz/host/api.foreverbetter.xyz/llms.txt)