> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wealthyhood.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Get universe configuration
> Retrieve the complete investment universe and discovery configuration
The universe configuration endpoint provides static metadata about all available investment
products, discovery sections, and savings configuration. This data is served from an edge
network for low-latency access.
This endpoint runs on a **separate domain** from the main B2B API and does not require authentication.
Configuration is tenant-specific based on the URL path.
## Language support
You can specify the language for localized content by including the `Accept-Language` header in your request. If the header is not provided, the endpoint defaults to English (`en`).
Language code for localized content. Supported values: `en`, `el`. If not provided or invalid, defaults to `en`.
```bash cURL theme={null}
curl -X GET 'https://{TENANT}-staging.wealthyhood.workers.dev/b2b/app-config' \
-H 'Accept: application/json' \
-H 'Accept-Language: en'
```
```javascript Node.js theme={null}
const CONFIG_BASE = "https://{TENANT}-staging.wealthyhood.workers.dev";
async function getUniverseConfig(language = "en") {
const res = await fetch(`${CONFIG_BASE}/b2b/app-config`, {
headers: {
Accept: "application/json",
"Accept-Language": language
}
});
if (!res.ok) throw new Error(`Config fetch failed: ${res.status}`);
return res.json();
}
```
```json Success theme={null}
{
"investmentUniverse": {
"assetClasses": {
"equities": {
"fieldName": "Stocks",
"keyName": "equities"
},
"bonds": {
"fieldName": "Bonds",
"keyName": "bonds"
},
"commodities": {
"fieldName": "Commodities",
"keyName": "commodities"
}
},
"assets": {
"equities_apple": {
"assetClass": "equities",
"simpleName": "Apple",
"formalName": "Apple Inc. (AAPL)",
"isin": "US0378331005",
"formalTicker": "AAPL",
"formalExchange": "US",
"displayExchange": "NASDAQ",
"tradedCurrency": "USD",
"category": "stock",
"sector": "technology",
"shortDescription": "Smart phones",
"about": "Apple designs and manufactures consumer electronics.",
"logoUrl": "https://public-assets.wealthyhood.cloud/logos/equities_apple.svg",
"tags": ["fractional"],
"searchTerms": ["Technology", "Smartphone", "Computer", "Hardware"],
"tickerWithCurrency": "$AAPL"
}
},
"sectors": {
"technology": {
"fieldName": "Technology",
"keyName": "technology"
}
},
"geographies": {
"global": {
"name": "Global",
"explanation": "Invest in assets from the US, Europe, Asia & Emerging Markets",
"keyName": "global"
}
},
"providers": {
"vanguard": {
"displayName": "Vanguard",
"icon": "vanguard.svg",
"keyName": "vanguard"
}
}
},
"discovery": {
"topMovers": {
"best": [
{
"asset": "equities_nvidia",
"returnPercentage": 0.15
}
],
"worst": [
{
"asset": "equities_intel",
"returnPercentage": -0.08
}
]
},
"popularAssetsSection": [
"equities_nvidia",
"equities_apple",
"equities_microsoft"
],
"collections": {
"big_tech": {
"label": "Big tech",
"emoji": "💪",
"assets": [
"equities_microsoft",
"equities_apple",
"equities_nvidia"
]
}
}
},
"deposits": {
"minimumAmount": 1
},
"savingsConfig": {
"minimumSavingsTopupAmount": 1,
"minimumSavingsWithdrawalAmount": 0.02
}
}
```
If you don't include the `Accept-Language` header, the endpoint will automatically use English (`en`) as the default language.
## See also
* [Flows → Investment Universe](/flows/investment-universe) - Complete integration guide
* [API Reference → Investment Products](/api-reference/investment-products/investment-products) - Live trading data
* [Screens → Discover Assets](/screens/discover-assets) - Building discovery screens
## OpenAPI
````yaml GET /b2b/app-config
openapi: 3.0.3
info:
title: Wealthyhood Universe Configuration API
version: 1.0.0
description: >
Edge-deployed configuration service providing the investment universe
metadata,
discovery data, and savings configuration. This service runs on a separate
domain
from the main B2B API and is designed for low-latency, high-availability
access
to static configuration data.
**Important**: This API does not require authentication and returns
tenant-specific
configuration based on the endpoint path.
servers:
- url: https://{host}
variables:
host:
default: '{TENANT}-staging.wealthyhood.workers.dev'
description: Wealthyhood Universe Config edge server
security: []
tags:
- name: Universe Configuration
description: Static configuration data for the investment universe
paths:
/b2b/app-config:
get:
tags:
- Universe Configuration
summary: Get universe configuration
description: >
Retrieve the complete universe configuration for a tenant, including:
- **Investment Universe**: Asset classes, assets, sectors, geographies,
and providers
- **Discovery**: Top movers, popular assets, collections, ETF sections,
and ready-made portfolios
- **Deposits Configuration**: Minimum deposit amounts
- **Savings Configuration**: Savings fund details and configuration
The response content can be localized by including the `Accept-Language`
header. If not provided, defaults to `en` (English).
operationId: getUniverseConfig
parameters:
- name: Accept-Language
in: header
required: false
description: >-
Language code for localized content. Supported values: `en`, `el`.
Defaults to `en` if not provided or invalid.
schema:
type: string
enum:
- en
- el
default: en
example: en
responses:
'200':
description: Universe configuration for the tenant
content:
application/json:
schema:
$ref: '#/components/schemas/UniverseConfigResponse'
examples:
universeConfig:
summary: Universe configuration response
value:
investmentUniverse:
assetClasses:
equities:
fieldName: Stocks
keyName: equities
bonds:
fieldName: Bonds
keyName: bonds
commodities:
fieldName: Commodities
keyName: commodities
assets:
equities_apple:
assetClass: equities
simpleName: Apple
formalName: Apple Inc. (AAPL)
isin: US0378331005
formalTicker: AAPL
formalExchange: US
displayExchange: NASDAQ
tradedCurrency: USD
category: stock
sector: technology
shortDescription: Smart phones
about: Apple designs and manufactures consumer electronics.
logoUrl: >-
https://public-assets.wealthyhood.cloud/logos/equities_apple.svg
tags:
- fractional
searchTerms:
- Technology
- Smartphone
- Computer
- Hardware
tickerWithCurrency: $AAPL
sectors:
technology:
fieldName: Technology
keyName: technology
geographies:
global:
name: Global
explanation: >-
Invest in assets from the US, Europe, Asia &
Emerging Markets
keyName: global
providers:
vanguard:
displayName: Vanguard
icon: vanguard.svg
keyName: vanguard
discovery:
topMovers:
best:
- asset: equities_nvidia
returnPercentage: 0.15
worst:
- asset: equities_intel
returnPercentage: -0.08
popularAssetsSection:
- equities_nvidia
- equities_apple
- equities_microsoft
collections:
big_tech:
label: Big tech
emoji: 💪
assets:
- equities_microsoft
- equities_apple
- equities_nvidia
deposits:
minimumAmount: 1
savingsConfig:
minimumSavingsTopupAmount: 1
minimumSavingsWithdrawalAmount: 0.02
'404':
description: Tenant configuration not found
content:
application/json:
schema:
type: object
properties:
error:
type: string
example:
error: Configuration not found for tenant
components:
schemas:
UniverseConfigResponse:
type: object
properties:
investmentUniverse:
$ref: '#/components/schemas/InvestmentUniverse'
discovery:
$ref: '#/components/schemas/Discovery'
deposits:
$ref: '#/components/schemas/DepositsConfig'
savingsConfig:
$ref: '#/components/schemas/SavingsConfig'
savingsUniverse:
type: object
description: Money market fund configurations for savings products
additionalProperties:
$ref: '#/components/schemas/SavingsProduct'
required:
- investmentUniverse
- discovery
- deposits
- savingsConfig
InvestmentUniverse:
type: object
description: Complete investment universe metadata
properties:
assetClasses:
type: object
description: Available asset classes (equities, bonds, commodities, etc.)
additionalProperties:
$ref: '#/components/schemas/AssetClass'
assets:
type: object
description: Complete catalog of available assets keyed by internal identifier
additionalProperties:
$ref: '#/components/schemas/AssetConfig'
sectors:
type: object
description: Market sectors for categorization
additionalProperties:
$ref: '#/components/schemas/Sector'
geographies:
type: object
description: Geographic regions for filtering
additionalProperties:
$ref: '#/components/schemas/Geography'
providers:
type: object
description: ETF/fund providers (Vanguard, iShares, etc.)
additionalProperties:
$ref: '#/components/schemas/Provider'
bondCategories:
type: object
description: Bond classification categories
additionalProperties:
$ref: '#/components/schemas/BondCategory'
required:
- assetClasses
- assets
- sectors
- geographies
- providers
Discovery:
type: object
description: Curated discovery content for asset exploration
properties:
topMovers:
$ref: '#/components/schemas/TopMovers'
popularAssetsSection:
type: array
description: Asset keys for popular assets display
items:
type: string
example:
- equities_nvidia
- equities_apple
collections:
type: object
description: Themed asset collections
additionalProperties:
$ref: '#/components/schemas/Collection'
etfSection:
$ref: '#/components/schemas/ETFSection'
readyMadePortfolios:
type: array
description: Pre-built portfolio asset keys
items:
type: string
required:
- topMovers
- popularAssetsSection
- collections
DepositsConfig:
type: object
properties:
minimumAmount:
type: number
description: Minimum deposit amount in major currency units
example: 1
required:
- minimumAmount
SavingsConfig:
type: object
properties:
minimumSavingsTopupAmount:
type: number
description: Minimum amount to add to savings
example: 1
minimumSavingsWithdrawalAmount:
type: number
description: Minimum amount to withdraw from savings
example: 0.02
required:
- minimumSavingsTopupAmount
- minimumSavingsWithdrawalAmount
SavingsProduct:
type: object
description: Money market fund configuration for savings
properties:
label:
type: string
description: Display label
example: Savings EUR
fee:
type: number
format: float
description: Management fee as decimal
example: 0.1
storedCurrency:
type: string
description: Internal currency code
example: EUC
fundName:
type: string
description: Full fund name
fundManager:
type: string
description: Fund manager name
example: Blackrock
isin:
type: string
description: Fund ISIN
benchmark:
type: string
description: Benchmark rate name
baseCurrency:
type: string
description: Fund base currency
example: EUR
income:
type: string
enum:
- Distributing
- Accumulating
distribution:
type: string
description: Distribution frequency
example: Monthly
key:
type: string
description: Internal key
rating:
type: string
description: Overall fund rating
example: AAA
regions:
type: array
items:
type: string
creditRatings:
type: array
description: Credit ratings from various agencies
items:
$ref: '#/components/schemas/CreditRating'
ratingSubtitle:
type: string
description: Explanation of rating significance
risk:
$ref: '#/components/schemas/RiskIndicator'
infoConfig:
type: object
description: Educational content configuration
additionalProperties:
$ref: '#/components/schemas/InfoSection'
AssetClass:
type: object
properties:
fieldName:
type: string
description: Display name for the asset class
example: Stocks
keyName:
type: string
description: Internal key identifier
example: equities
required:
- fieldName
- keyName
AssetConfig:
type: object
description: Complete configuration for a single asset
properties:
assetClass:
type: string
description: Key reference to asset class
example: equities
simpleName:
type: string
description: Human-readable short name
example: Apple
formalName:
type: string
description: Full formal name with ticker
example: Apple Inc. (AAPL)
isin:
type: string
description: 12-character ISIN identifier
pattern: ^[A-Z0-9]{12}$
example: US0378331005
formalTicker:
type: string
description: Exchange ticker symbol
example: AAPL
formalExchange:
type: string
description: Exchange code for data providers
example: US
displayExchange:
type: string
description: Human-readable exchange name
example: NASDAQ
tradedCurrency:
type: string
description: Primary trading currency
enum:
- USD
- EUR
- GBP
- GBX
example: USD
baseCurrency:
type: string
description: Base currency for the asset
example: USD
category:
type: string
description: Instrument type
enum:
- stock
- etf
example: stock
sector:
type: string
description: Market sector key
example: technology
provider:
type: string
description: ETF provider key (for ETFs only)
example: vanguard
shortDescription:
type: string
description: Brief one-line description
example: Smart phones
about:
type: string
description: Full description paragraph
logoUrl:
type: string
format: uri
description: URL to asset logo image
example: https://public-assets.wealthyhood.cloud/logos/equities_apple.svg
tags:
type: array
description: Trading capability tags
items:
type: string
example:
- fractional
searchTerms:
type: array
description: Keywords for search functionality
items:
type: string
example:
- Technology
- Smartphone
kid:
type: string
format: uri
description: Key Information Document URL (for ETFs)
tickerWithCurrency:
type: string
description: Ticker prefixed with currency symbol
example: $AAPL
sorting:
type: integer
description: Display order priority
income:
type: string
description: Income distribution type (for ETFs)
enum:
- Accumulating
- Distributing
replication:
type: string
description: ETF replication method
enum:
- Physical
- Synthetic
index:
type: string
description: Tracked index name (for ETFs)
assetClassBreakdown:
type: object
description: Asset allocation breakdown (for multi-asset ETFs)
additionalProperties:
type: number
format: float
eodOnly:
type: boolean
description: Whether asset only has end-of-day pricing
similarCompanies:
type: array
description: Related companies for discovery
items:
type: string
typos:
type: array
description: Common misspellings for search
items:
type: string
required:
- assetClass
- simpleName
- isin
- formalTicker
- tradedCurrency
- category
Sector:
type: object
properties:
fieldName:
type: string
description: Display name
example: Technology
keyName:
type: string
description: Internal key
example: technology
required:
- fieldName
- keyName
Geography:
type: object
properties:
name:
type: string
description: Display name
example: Global
explanation:
type: string
description: Description of geographic coverage
example: Invest in assets from the US, Europe, Asia & Emerging Markets
keyName:
type: string
description: Internal key
example: global
required:
- name
- keyName
Provider:
type: object
properties:
displayName:
type: string
description: Display name
example: Vanguard
icon:
type: string
description: Icon filename
example: vanguard.svg
keyName:
type: string
description: Internal key
example: vanguard
required:
- displayName
- keyName
BondCategory:
type: object
properties:
fieldName:
type: string
example: Corporate Bonds
keyName:
type: string
example: corporate
required:
- fieldName
- keyName
TopMovers:
type: object
properties:
best:
type: array
description: Top gaining assets
items:
$ref: '#/components/schemas/TopMoverItem'
worst:
type: array
description: Top losing assets
items:
$ref: '#/components/schemas/TopMoverItem'
required:
- best
- worst
Collection:
type: object
properties:
label:
type: string
description: Collection display name
example: Big tech
emoji:
type: string
description: Collection emoji icon
example: 💪
assets:
type: array
description: Asset keys in this collection
items:
type: string
required:
- label
- assets
ETFSection:
type: object
properties:
top:
type: array
description: Featured top ETFs
items:
type: string
popularIndex:
type: array
description: Popular index tracking ETFs
items:
type: string
CreditRating:
type: object
properties:
label:
type: string
example: Moody's rating
rating:
type: string
example: AAA-mf
RiskIndicator:
type: object
properties:
score:
type: integer
minimum: 1
maximum: 7
example: 1
scale:
type: integer
example: 7
subtitle:
type: string
InfoSection:
type: object
properties:
title:
type: string
paragraphs:
type: array
items:
type: string
TopMoverItem:
type: object
properties:
asset:
type: string
description: Asset key
example: equities_nvidia
returnPercentage:
type: number
format: float
description: Return as decimal (0.15 = 15%)
example: 0.15
required:
- asset
- returnPercentage
````