{"uid":"cap_ZllV6MBLGxrGozUfRARnu","slug":"forever-better-wellnizz-genetics-ancestry-api-6cde5e43","name":"Forever Better / Wellnizz Genetics Ancestry API","description":"Generate ancestry proportions and map data from a genetics source owned by the paying wallet.","url":"https://api.foreverbetter.xyz/genetics/ancestry","method":"POST","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"type":"json","example":{"status":"complete","ancestry":[],"geographic_map":{"regions":[]}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_v7FBM3kVvTPl8mJJtVc4Z","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Generates ancestry proportions and geographic map data from an imported genetics source owned by the paying wallet.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Personal ancestry discovery from DNA","prompt":"I just imported my raw DNA file and got a source ID of src_xyz789 — can you generate my ancestry proportions at the regional level so I can see which parts of the world my genetics come from?"},{"title":"Continental ancestry overview for health context","prompt":"Run an ancestry analysis on my genetics source src_def456 at continental resolution so I can understand my broad ethnic background before reviewing my health recommendations."},{"title":"Detailed sub-population ancestry for genealogy research","prompt":"I'm tracing my family history — can you use genetics source src_ghi321 to generate a sub-population ancestry breakdown with map data so I can see specific population groups I descend from?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:39:48.830Z","isFirstParty":false}