@firela/api-types 0.0.0-canary.7b647d33 → 0.0.0-canary.824fea47

package/src/generated/schemas.gen.ts

@@ -6,18 +6,12 @@ export const $CreateAccountDto = {
     path: {
       type: 'string',
       description: 'Account path (hierarchical, colon-separated)',
-      example: 'Assets:CN:Bank:ICBC:Checking'
-    },
-    displayName: {
-      type: 'string',
-      description:
-        'Display name to distinguish accounts at the same path (default: "")',
-      example: '工资卡'
+      example: 'Assets:CN:ICBC:Checking'
     },
     openDate: {
       format: 'date-time',
       type: 'string',
-      description: 'Account open date',
+      description: 'Account open date (server defaults to today)',
       example: '2024-01-01'
     },
     currencies: {
@@ -45,26 +39,22 @@ export const $CreateAccountDto = {
     templatePath: {
       type: 'string',
       description: 'Reference to account-standards template path',
-      example: 'Assets:CN:Bank:ICBC:Checking'
+      example: 'Assets:CN:Checking'
     },
     isCustom: {
       type: 'boolean',
       description: 'Whether this is a custom (user-created) account',
       default: false
     },
-    i18nKey: {
-      type: 'string',
-      description: 'i18n key for display name (overrides template)',
-      example: 'account.custom.mybank'
-    },
     icon: {
       type: 'string',
       description: 'Icon identifier (overrides template)',
       example: 'bank-custom'
     },
-    openMeta: {
+    openDirectiveMeta: {
       type: 'object',
-      description: 'Additional metadata',
+      description:
+        'Open directive metadata (NOT an opening-balance amount — use the opening-balance endpoint)',
       example: {
         branch: 'Downtown',
         accountNumber: '1234'
@@ -76,7 +66,7 @@ export const $CreateAccountDto = {
       example: 'c98e5d4a-2f71-4a5a-bb3c-92c9f231d5e2'
     }
   },
-  required: ['path', 'openDate']
+  required: ['path']
 } as const;
 
 export const $AccountResponseDto = {
@@ -90,13 +80,7 @@ export const $AccountResponseDto = {
     path: {
       type: 'string',
       description: 'Account path (hierarchical, colon-separated)',
-      example: 'Assets:CN:Bank:ICBC:Checking'
-    },
-    displayName: {
-      type: 'string',
-      description:
-        'Display name distinguishing multiple accounts at the same path',
-      example: '工资卡'
+      example: 'Assets:CN:ICBC:Checking'
     },
     type: {
       type: 'string',
@@ -104,6 +88,47 @@ export const $AccountResponseDto = {
       enum: ['Assets', 'Liabilities', 'Income', 'Expenses', 'Equity'],
       example: 'Assets'
     },
+    assetSubClass: {
+      type: 'string',
+      description:
+        'Account-level asset sub-class (product type, e.g. STOCK/DEPOSIT/CREDIT_CARD/PERSONAL_LOAN). Computed from the account path via the asset-classifier (ADR-0077). Null for non-asset accounts (Income/Expenses/Equity) or unmatched paths.',
+      enum: [
+        'DEPOSIT',
+        'CASH',
+        'MONEY_MARKET_FUND',
+        'STOCK',
+        'ETF',
+        'MUTUAL_FUND',
+        'EQUITY_COMPENSATION',
+        'GOVERNMENT_BOND',
+        'CORPORATE_BOND',
+        'BOND_FUND',
+        'PRIMARY_RESIDENCE',
+        'INVESTMENT_PROPERTY',
+        'REIT',
+        'GOLD',
+        'SILVER',
+        'PRECIOUS_METAL',
+        'PRECIOUS_METAL_FUND',
+        'COMMODITY',
+        'COMMODITY_FUND',
+        'CRYPTOCURRENCY',
+        'RETIREMENT_ACCOUNT',
+        'HEALTH_ACCOUNT',
+        'EDUCATION_ACCOUNT',
+        'INSURANCE',
+        'PRIVATE_EQUITY',
+        'HEDGE_FUND',
+        'COLLECTIBLES',
+        'MORTGAGE',
+        'STUDENT_LOAN',
+        'CREDIT_CARD',
+        'PERSONAL_LOAN',
+        'OTHER'
+      ],
+      nullable: true,
+      example: 'STOCK'
+    },
     status: {
       type: 'string',
       description: 'Account status',
@@ -145,26 +170,26 @@ export const $AccountResponseDto = {
     templatePath: {
       type: 'string',
       description: 'Template path reference',
-      example: 'Assets:CN:Bank:ICBC:Checking'
+      example: 'Assets:CN:Checking'
     },
     isCustom: {
       type: 'boolean',
       description: 'Whether this is a custom (user-created) account',
       example: false
     },
-    i18nKey: {
+    displayName: {
       type: 'string',
-      description: 'i18n key for display name',
-      example: 'account.assets.cn.bank.icbc.checking'
+      description: 'Localized display name (ADR-0114, read-time projection)',
+      example: 'Checking'
     },
     icon: {
       type: 'string',
       description: 'Icon identifier',
       example: 'bank-icbc'
     },
-    openMeta: {
+    openDirectiveMeta: {
       type: 'object',
-      description: 'Account metadata',
+      description: 'Open directive metadata (ADR-0115 Decision 9)',
       example: {
         branch: 'Downtown'
       }
@@ -192,7 +217,6 @@ export const $AccountResponseDto = {
   required: [
     'id',
     'path',
-    'displayName',
     'type',
     'status',
     'openDate',
@@ -225,11 +249,6 @@ export const $AccountListResponseDto = {
 export const $UpdateAccountDto = {
   type: 'object',
   properties: {
-    displayName: {
-      type: 'string',
-      description: 'Display name to distinguish accounts at the same path',
-      example: '招行工资卡'
-    },
     currencies: {
       description: 'Allowed currencies (null = no restriction)',
       example: ['CNY', 'USD'],
@@ -251,19 +270,15 @@ export const $UpdateAccountDto = {
         'NONE'
       ]
     },
-    i18nKey: {
-      type: 'string',
-      description: 'i18n key for display name',
-      example: 'account.custom.mybank'
-    },
     icon: {
       type: 'string',
       description: 'Icon identifier',
       example: 'bank-custom'
     },
-    openMeta: {
+    openDirectiveMeta: {
       type: 'object',
-      description: 'Additional metadata (merged with existing)',
+      description:
+        'Open directive metadata (merged with existing; NOT an opening-balance amount)',
       example: {
         branch: 'Uptown'
       }
@@ -310,13 +325,47 @@ export const $ReopenAccountDto = {
   }
 } as const;
 
+export const $CreateOpeningBalanceDto = {
+  type: 'object',
+  properties: {
+    amount: {
+      type: 'number',
+      description: 'Opening balance amount (non-negative)',
+      example: 1000
+    },
+    currency: {
+      type: 'string',
+      description: 'Currency code',
+      example: 'CNY'
+    },
+    date: {
+      format: 'date-time',
+      type: 'string',
+      description: 'Opening-balance date (defaults to now)',
+      example: '2024-01-01'
+    }
+  },
+  required: ['amount', 'currency']
+} as const;
+
+export const $OpeningBalanceResultDto = {
+  type: 'object',
+  properties: {
+    transactionId: {
+      type: 'string',
+      description: 'Created opening-balance transaction id.'
+    }
+  },
+  required: ['transactionId']
+} as const;
+
 export const $AccountStandardResponseDto = {
   type: 'object',
   properties: {
     path: {
       type: 'string',
       description: 'Account path (hierarchical, colon-separated)',
-      example: 'Assets:CN:Bank:ICBC:Checking'
+      example: 'Assets:CN:Checking'
     },
     type: {
       type: 'string',
@@ -324,11 +373,6 @@ export const $AccountStandardResponseDto = {
       enum: ['Assets', 'Liabilities', 'Income', 'Expenses', 'Equity'],
       example: 'Assets'
     },
-    i18nKey: {
-      type: 'string',
-      description: 'i18n key for localized display name',
-      example: 'account.assets.cn.bank.icbc.checking'
-    },
     name: {
       type: 'string',
       description: 'Short localized display name',
@@ -353,7 +397,7 @@ export const $AccountStandardResponseDto = {
       example: 'bank-icbc'
     }
   },
-  required: ['path', 'type', 'i18nKey', 'description', 'tags', 'icon']
+  required: ['path', 'type', 'description', 'tags', 'icon']
 } as const;
 
 export const $AccountStandardListResponseDto = {
@@ -383,18 +427,13 @@ export const $AccountStandardListResponseDto = {
 export const $TemplateMetadataDto = {
   type: 'object',
   properties: {
-    extendable: {
-      type: 'boolean',
-      description: 'Whether this path can be extended',
-      example: true
-    },
     rootType: {
       type: 'string',
       description: 'Root account type',
       example: 'Assets'
     }
   },
-  required: ['extendable', 'rootType']
+  required: ['rootType']
 } as const;
 
 export const $TemplateMetadataResponseDto = {
@@ -533,7 +572,7 @@ export const $CreatePostingDto = {
       type: 'string',
       description:
         'Account name in Beancount format (must start with uppercase, colon-separated)',
-      example: 'Assets:Bank:Checking'
+      example: 'Assets:Checking'
     },
     units: {
       type: 'string',
@@ -692,7 +731,7 @@ export const $PostingResponseDto = {
     account: {
       type: 'string',
       description: 'Account name',
-      example: 'Assets:Bank:Checking'
+      example: 'Assets:Checking'
     },
     units: {
       type: 'string',
@@ -1058,7 +1097,7 @@ export const $PostingDetailDto = {
     account: {
       type: 'string',
       description: 'Fully-qualified Beancount account path',
-      example: 'Assets:Bank:Checking'
+      example: 'Assets:Checking'
     },
     units: {
       type: 'string',
@@ -1247,6 +1286,77 @@ export const $TransactionDetailDto = {
   ]
 } as const;
 
+export const $BalanceByCurrencyDto = {
+  type: 'object',
+  properties: {
+    currency: {
+      type: 'string',
+      description: 'ISO 4217 currency code',
+      example: 'CNY'
+    },
+    balance: {
+      type: 'string',
+      description: 'Balance amount',
+      example: '50000.00'
+    }
+  },
+  required: ['currency', 'balance']
+} as const;
+
+export const $ExchangeRateWarningDto = {
+  type: 'object',
+  properties: {
+    type: {
+      type: 'string',
+      description: 'Warning type',
+      example: 'MISSING_EXCHANGE_RATE'
+    },
+    currency: {
+      type: 'string',
+      description: 'Currency without exchange rate',
+      example: 'EUR'
+    },
+    totalAmount: {
+      type: 'string',
+      description: 'Total amount affected',
+      example: '1000.00'
+    }
+  },
+  required: ['type', 'currency', 'totalAmount']
+} as const;
+
+export const $TransactionListSummaryDto = {
+  type: 'object',
+  properties: {
+    totalAmount: {
+      type: 'string',
+      description:
+        'Partial converted total in base currency (rated currencies only, raw Beancount sign). When warnings is non-empty this excludes currencies missing an FX rate; may be "0.00" if ALL non-base currencies lack a rate. Converted at the dateTo (or current) available rate.',
+      example: '-6000.00'
+    },
+    currency: {
+      type: 'string',
+      description: 'Base currency (ISO 4217)',
+      example: 'CNY'
+    },
+    balanceByCurrency: {
+      description: 'Raw (unconverted) balance per currency',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/BalanceByCurrencyDto'
+      }
+    },
+    warnings: {
+      description: 'Currencies missing an FX rate (omitted when empty)',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/ExchangeRateWarningDto'
+      }
+    }
+  },
+  required: ['totalAmount', 'currency', 'balanceByCurrency']
+} as const;
+
 export const $TransactionListResponseDto = {
   type: 'object',
   properties: {
@@ -1271,6 +1381,15 @@ export const $TransactionListResponseDto = {
       type: 'number',
       description: 'Number of items skipped',
       example: 0
+    },
+    summary: {
+      description:
+        'Amount summary for the full filtered set (#514). Present only when the request has a single account OR category viewpoint; omitted for search-only / plain-list / dual-perspective requests.',
+      allOf: [
+        {
+          $ref: '#/components/schemas/TransactionListSummaryDto'
+        }
+      ]
     }
   },
   required: ['data', 'total', 'limit', 'offset']
@@ -1370,7 +1489,7 @@ export const $BalanceResponseDto = {
     account: {
       type: 'string',
       description: 'Account name',
-      example: 'Assets:Bank:Checking'
+      example: 'Assets:Checking'
     },
     balance: {
       type: 'string',
@@ -1397,7 +1516,7 @@ export const $MultiCurrencyBalanceResponseDto = {
     account: {
       type: 'string',
       description: 'Account name',
-      example: 'Assets:Bank:Checking'
+      example: 'Assets:Checking'
     },
     balances: {
       type: 'object',
@@ -1453,7 +1572,7 @@ export const $TransactionSummaryDto = {
     accountName: {
       type: 'string',
       description: 'Source account name (first posting)',
-      example: 'Assets:Bank:Checking'
+      example: 'Assets:Checking'
     },
     sourceType: {
       type: 'string',
@@ -2745,117 +2864,274 @@ export const $UpdateCommodityDto = {
   }
 } as const;
 
-export const $CreateRecurringRuleDto = {
+export const $CreateBeanPriceDto = {
   type: 'object',
   properties: {
-    name: {
-      type: 'string',
-      description: 'Rule name (unique per user)',
-      maxLength: 100
-    },
-    icon: {
-      type: 'string',
-      description: 'Icon emoji',
-      maxLength: 10
-    },
-    frequency: {
-      type: 'string',
-      description: 'Recurring frequency',
-      enum: [
-        'WEEKLY',
-        'BIWEEKLY',
-        'MONTHLY',
-        'BIMONTHLY',
-        'QUARTERLY',
-        'YEARLY',
-        'CUSTOM'
-      ]
-    },
-    expectedAmount: {
-      type: 'number',
-      description: 'Expected amount (positive number)',
-      minimum: 0
-    },
-    expectedDay: {
-      type: 'number',
-      description: 'Expected day of month (1-31)',
-      minimum: 1,
-      maximum: 31
-    },
-    customIntervalDays: {
-      type: 'number',
-      description: 'Custom interval in days (required for CUSTOM frequency)',
-      minimum: 1
-    },
     currency: {
       type: 'string',
-      description: 'Currency code',
-      default: 'CNY',
-      maxLength: 10
+      description: 'Currency being priced (e.g., USD, AAPL, BTC)',
+      example: 'USD'
     },
-    matchPayeePattern: {
+    quoteCurrency: {
       type: 'string',
-      description: 'Payee matching pattern (supports wildcards)',
-      maxLength: 200
+      description: 'Quote currency (pricing currency, e.g., CNY, EUR)',
+      example: 'CNY'
     },
-    matchAmountTolerance: {
+    amount: {
       type: 'number',
-      description: 'Amount tolerance percentage (0-1)',
-      default: 0.075,
-      minimum: 0,
-      maximum: 1
-    },
-    defaultExpenseAccount: {
-      type: 'string',
-      description: 'Default expense account for auto-create',
-      maxLength: 200
-    },
-    defaultPaymentAccount: {
-      type: 'string',
-      description: 'Default payment account for auto-create',
-      maxLength: 200
-    },
-    defaultPayee: {
-      type: 'string',
-      description: 'Default payee for auto-create',
-      maxLength: 200
-    },
-    autoCreate: {
-      type: 'boolean',
-      description: 'Auto-create transaction when expected date arrives',
-      default: false
+      description:
+        'Price amount (MUST be >= 0 per Beancount spec, supports up to 15 decimal places). Zero allowed for conversion entries, negative strictly prohibited.',
+      example: 175.5,
+      minimum: 0
     },
-    startDate: {
+    date: {
       type: 'string',
-      description: 'Rule start date (ISO format)'
+      description: 'Price date (ISO 8601 format)',
+      example: '2024-11-05'
     },
-    endDate: {
-      type: 'string',
-      description: 'Rule end date (ISO format)'
+    metadata: {
+      type: 'object',
+      description:
+        'Metadata (validated by Zod schema, max field lengths enforced)',
+      example: {
+        source: 'MANUAL',
+        note: 'Bank valuation report',
+        confidence: 0.95
+      }
     }
   },
-  required: [
-    'name',
-    'frequency',
-    'expectedAmount',
-    'currency',
-    'matchAmountTolerance',
-    'autoCreate'
-  ]
+  required: ['currency', 'quoteCurrency', 'amount', 'date']
 } as const;
 
-export const $RecurringRuleResponseDto = {
+export const $PriceResponseDto = {
   type: 'object',
   properties: {
     id: {
       type: 'string',
-      description: 'Rule ID'
+      description: 'Unique identifier',
+      example: 'uuid-123-456'
     },
     userId: {
       type: 'string',
-      description: 'User ID'
+      description: 'User ID (owner of the price)',
+      example: 'user-123'
     },
-    name: {
+    currency: {
+      type: 'string',
+      description: 'Currency being priced (e.g., USD, AAPL, BTC)',
+      example: 'BTC'
+    },
+    quoteCurrency: {
+      type: 'string',
+      description: 'Quote currency (pricing currency, e.g., USD, CNY)',
+      example: 'USD'
+    },
+    amount: {
+      type: 'number',
+      description:
+        'Price amount (corresponds to Beancount Amount.number). Supports up to 15 decimal places.',
+      example: 50000
+    },
+    date: {
+      type: 'string',
+      description:
+        'Price date (ISO 8601 format). Represents the date this price was valid.',
+      example: '2024-01-01',
+      format: 'date'
+    },
+    meta: {
+      type: 'object',
+      description:
+        'Metadata (corresponds to Beancount meta field). Contains source, confidence, note, etc.',
+      example: {
+        source: 'MANUAL',
+        note: 'User-defined price',
+        confidence: 1
+      }
+    },
+    createdAt: {
+      format: 'date-time',
+      type: 'string',
+      description: 'Creation timestamp',
+      example: '2024-11-03T10:00:00Z'
+    },
+    updatedAt: {
+      format: 'date-time',
+      type: 'string',
+      description: 'Last update timestamp',
+      example: '2024-11-03T10:00:00Z'
+    }
+  },
+  required: [
+    'id',
+    'userId',
+    'currency',
+    'quoteCurrency',
+    'amount',
+    'date',
+    'meta',
+    'createdAt',
+    'updatedAt'
+  ]
+} as const;
+
+export const $PriceListResponseDto = {
+  type: 'object',
+  properties: {
+    items: {
+      description: 'List of prices',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/PriceResponseDto'
+      }
+    },
+    total: {
+      type: 'number',
+      description: 'Total number of prices',
+      example: 42
+    }
+  },
+  required: ['items', 'total']
+} as const;
+
+export const $UpdateBeanPriceDto = {
+  type: 'object',
+  properties: {
+    currency: {
+      type: 'string',
+      description: 'Currency being priced'
+    },
+    quoteCurrency: {
+      type: 'string',
+      description: 'Quote currency (pricing currency)'
+    },
+    amount: {
+      type: 'number',
+      description: 'Price amount (MUST be >= 0 per Beancount spec)',
+      minimum: 0
+    },
+    date: {
+      type: 'string',
+      description: 'Price date (ISO 8601 format)'
+    },
+    metadata: {
+      type: 'object',
+      description: 'Metadata'
+    }
+  }
+} as const;
+
+export const $CreateRecurringRuleDto = {
+  type: 'object',
+  properties: {
+    name: {
+      type: 'string',
+      description: 'Rule name (unique per user)',
+      maxLength: 100
+    },
+    icon: {
+      type: 'string',
+      description: 'Icon emoji',
+      maxLength: 10
+    },
+    frequency: {
+      type: 'string',
+      description: 'Recurring frequency',
+      enum: [
+        'WEEKLY',
+        'BIWEEKLY',
+        'MONTHLY',
+        'BIMONTHLY',
+        'QUARTERLY',
+        'YEARLY',
+        'CUSTOM'
+      ]
+    },
+    expectedAmount: {
+      type: 'number',
+      description: 'Expected amount (positive number)',
+      minimum: 0
+    },
+    expectedDay: {
+      type: 'number',
+      description: 'Expected day of month (1-31)',
+      minimum: 1,
+      maximum: 31
+    },
+    customIntervalDays: {
+      type: 'number',
+      description: 'Custom interval in days (required for CUSTOM frequency)',
+      minimum: 1
+    },
+    currency: {
+      type: 'string',
+      description: 'Currency code',
+      default: 'CNY',
+      maxLength: 10
+    },
+    matchPayeePattern: {
+      type: 'string',
+      description: 'Payee matching pattern (supports wildcards)',
+      maxLength: 200
+    },
+    matchAmountTolerance: {
+      type: 'number',
+      description: 'Amount tolerance percentage (0-1)',
+      default: 0.075,
+      minimum: 0,
+      maximum: 1
+    },
+    defaultExpenseAccount: {
+      type: 'string',
+      description: 'Default expense account for auto-create',
+      maxLength: 200
+    },
+    defaultPaymentAccount: {
+      type: 'string',
+      description: 'Default payment account for auto-create',
+      maxLength: 200
+    },
+    defaultPayee: {
+      type: 'string',
+      description: 'Default payee for auto-create',
+      maxLength: 200
+    },
+    autoCreate: {
+      type: 'boolean',
+      description: 'Auto-create transaction when expected date arrives',
+      default: false
+    },
+    startDate: {
+      type: 'string',
+      description: 'Rule start date (ISO format)'
+    },
+    endDate: {
+      type: 'string',
+      description: 'Rule end date (ISO format)'
+    }
+  },
+  required: [
+    'name',
+    'frequency',
+    'expectedAmount',
+    'currency',
+    'matchAmountTolerance',
+    'autoCreate'
+  ]
+} as const;
+
+export const $RecurringRuleResponseDto = {
+  type: 'object',
+  properties: {
+    id: {
+      type: 'string',
+      description: 'Rule ID'
+    },
+    userId: {
+      type: 'string',
+      description: 'User ID'
+    },
+    name: {
       type: 'string',
       description: 'Rule name'
     },
@@ -3516,30 +3792,477 @@ export const $ForecastResponseDto = {
   ]
 } as const;
 
-export const $CreateTransactionRuleDto = {
+export const $CurrencyBalanceDto = {
   type: 'object',
   properties: {
-    name: {
+    currency: {
       type: 'string',
-      minLength: 1,
-      maxLength: 100
+      description: 'ISO 4217 currency code',
+      example: 'CNY'
     },
-    description: {
+    balance: {
       type: 'string',
-      maxLength: 500
+      description: 'Balance amount',
+      example: '500000.00'
+    }
+  },
+  required: ['currency', 'balance']
+} as const;
+
+export const $TimeSeriesPointDto = {
+  type: 'object',
+  properties: {
+    date: {
+      type: 'string',
+      description: 'Date in YYYY-MM-DD format',
+      example: '2024-06-15'
     },
-    narrationKeywords: {
-      items: {
-        type: 'array'
-      },
-      maxItems: 50,
-      type: 'array'
+    value: {
+      type: 'string',
+      description: 'Value at this date (in base currency)',
+      example: '500000.00'
     },
-    payeeKeywords: {
-      items: {
-        type: 'array'
-      },
-      maxItems: 50,
+    change: {
+      type: 'object',
+      description: 'Change from previous point',
+      example: '5000.00'
+    },
+    assets: {
+      type: 'string',
+      description: 'Total assets at this date (in base currency)',
+      example: '494338.00'
+    },
+    liabilities: {
+      type: 'string',
+      description: 'Total liabilities at this date (in base currency)',
+      example: '310098.00'
+    },
+    byCurrency: {
+      description: 'Multi-currency breakdown for this point',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/CurrencyBalanceDto'
+      }
+    }
+  },
+  required: ['date', 'value']
+} as const;
+
+export const $TrendSummaryDto = {
+  type: 'object',
+  properties: {
+    startValue: {
+      type: 'string',
+      description: 'Value at start of period',
+      example: '450000.00'
+    },
+    endValue: {
+      type: 'string',
+      description: 'Value at end of period',
+      example: '500000.00'
+    },
+    totalChange: {
+      type: 'string',
+      description: 'Total change over period',
+      example: '50000.00'
+    },
+    totalChangePercentage: {
+      type: 'string',
+      description: 'Total change percentage',
+      example: '+11.11%'
+    }
+  },
+  required: ['startValue', 'endValue', 'totalChange', 'totalChangePercentage']
+} as const;
+
+export const $MultiCurrencyPointDto = {
+  type: 'object',
+  properties: {
+    date: {
+      type: 'string',
+      description: 'Date in YYYY-MM-DD format',
+      example: '2024-06-15'
+    },
+    byCurrency: {
+      description: 'Balances by currency',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/CurrencyBalanceDto'
+      }
+    }
+  },
+  required: ['date', 'byCurrency']
+} as const;
+
+export const $PortfolioTrendsResponseDto = {
+  type: 'object',
+  properties: {
+    series: {
+      description: 'Time series data points',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/TimeSeriesPointDto'
+      }
+    },
+    summary: {
+      description: 'Period summary',
+      allOf: [
+        {
+          $ref: '#/components/schemas/TrendSummaryDto'
+        }
+      ]
+    },
+    period: {
+      type: 'string',
+      description: 'Period requested',
+      example: '6m'
+    },
+    granularity: {
+      type: 'string',
+      description: 'Data granularity',
+      example: 'month'
+    },
+    currency: {
+      type: 'string',
+      description: 'Base currency for converted values',
+      example: 'CNY'
+    },
+    byCurrency: {
+      description:
+        'Multi-currency time series (each point has currency breakdown)',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/MultiCurrencyPointDto'
+      }
+    },
+    warnings: {
+      description: 'Exchange rate warnings',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/ExchangeRateWarningDto'
+      }
+    }
+  },
+  required: ['series', 'summary', 'period', 'granularity', 'currency']
+} as const;
+
+export const $CashFlowPointDto = {
+  type: 'object',
+  properties: {
+    month: {
+      type: 'string',
+      description: 'Month key (YYYY-MM)',
+      example: '2024-03'
+    },
+    income: {
+      type: 'string',
+      description: 'Income in base currency (absolute, converted)',
+      example: '10000.00'
+    },
+    expense: {
+      type: 'string',
+      description: 'Expense in base currency (absolute, converted)',
+      example: '5000.00'
+    },
+    netSavings: {
+      type: 'string',
+      description: 'netSavings = income − expense (savings positive)',
+      example: '5000.00'
+    }
+  },
+  required: ['month', 'income', 'expense', 'netSavings']
+} as const;
+
+export const $CashFlowTrendSummaryDto = {
+  type: 'object',
+  properties: {
+    totalIncome: {
+      type: 'string',
+      description: 'Total income across the period',
+      example: '60000.00'
+    },
+    totalExpense: {
+      type: 'string',
+      description: 'Total expense across the period',
+      example: '30000.00'
+    },
+    totalNetSavings: {
+      type: 'string',
+      description: 'income − expense across the period',
+      example: '30000.00'
+    },
+    averageMonthlyNetSavings: {
+      type: 'string',
+      description:
+        'totalNetSavings divided by the window length (N months, incl. zero-filled)',
+      example: '5000.00'
+    }
+  },
+  required: [
+    'totalIncome',
+    'totalExpense',
+    'totalNetSavings',
+    'averageMonthlyNetSavings'
+  ]
+} as const;
+
+export const $CashFlowTrendsResponseDto = {
+  type: 'object',
+  properties: {
+    series: {
+      description:
+        'Monthly cash-flow series (fixed N-month window, zero-filled)',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/CashFlowPointDto'
+      }
+    },
+    summary: {
+      description: 'Period totals',
+      allOf: [
+        {
+          $ref: '#/components/schemas/CashFlowTrendSummaryDto'
+        }
+      ]
+    },
+    period: {
+      type: 'string',
+      description: 'Period requested',
+      example: '6m'
+    },
+    granularity: {
+      type: 'string',
+      description: 'Data granularity (v1 returns month buckets)',
+      example: 'month'
+    },
+    currency: {
+      type: 'string',
+      description: 'Base currency for converted values',
+      example: 'CNY'
+    },
+    warnings: {
+      description: 'Exchange rate warnings (e.g. missing rate for a currency)',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/ExchangeRateWarningDto'
+      }
+    }
+  },
+  required: ['series', 'summary', 'period', 'granularity', 'currency']
+} as const;
+
+export const $GenerateSnapshotBody = {
+  type: 'object',
+  properties: {}
+} as const;
+
+export const $GenerateSnapshotResponse = {
+  type: 'object',
+  properties: {}
+} as const;
+
+export const $BackfillSnapshotsBody = {
+  type: 'object',
+  properties: {}
+} as const;
+
+export const $BackfillSnapshotsResponse = {
+  type: 'object',
+  properties: {}
+} as const;
+
+export const $DeleteOwnUserDto = {
+  type: 'object',
+  properties: {
+    accessToken: {
+      type: 'string',
+      description: 'Access token for user verification',
+      example: 'abc123xyz'
+    }
+  },
+  required: ['accessToken']
+} as const;
+
+export const $SignupDto = {
+  type: 'object',
+  properties: {
+    turnstileToken: {
+      type: 'string',
+      description:
+        'Cloudflare Turnstile verification token (optional when Turnstile disabled)',
+      example: '0.abc123def456...'
+    }
+  }
+} as const;
+
+export const $SignupResponseDto = {
+  type: 'object',
+  properties: {
+    authToken: {
+      type: 'string',
+      description: 'JWT auth token',
+      example: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
+    },
+    accessToken: {
+      type: 'string',
+      description: 'Auto-generated access token'
+    },
+    role: {
+      type: 'string',
+      description: 'Assigned user role',
+      enum: ['USER', 'ADMIN', 'DEMO', 'INACTIVE', 'PAID', 'OPS']
+    }
+  },
+  required: ['authToken', 'accessToken', 'role']
+} as const;
+
+export const $UpdateUserSettingDto = {
+  type: 'object',
+  properties: {
+    secId: {
+      type: 'number',
+      description: 'Security ID'
+    },
+    annualInterestRate: {
+      type: 'number',
+      description: 'Annual interest rate',
+      example: 0.05
+    },
+    currency: {
+      type: 'string',
+      description: 'Currency code',
+      example: 'USD'
+    },
+    baseCurrency: {
+      type: 'string',
+      description: 'Base currency code',
+      example: 'USD'
+    },
+    benchmark: {
+      type: 'string',
+      description: 'Benchmark symbol',
+      example: 'SPY'
+    },
+    colorScheme: {
+      type: 'string',
+      description: 'Color scheme',
+      enum: ['DARK', 'LIGHT']
+    },
+    dateRange: {
+      type: 'string',
+      description: 'Date range filter',
+      example: '1y'
+    },
+    emergencyFund: {
+      type: 'number',
+      description: 'Emergency fund amount',
+      example: 10000
+    },
+    'filters.accounts': {
+      description: 'Account filter IDs',
+      type: 'array',
+      items: {
+        type: 'string'
+      }
+    },
+    'filters.assetClasses': {
+      description: 'Asset class filters',
+      type: 'array',
+      items: {
+        type: 'string'
+      }
+    },
+    'filters.dataSource': {
+      type: 'string',
+      description: 'Data source filter'
+    },
+    'filters.symbol': {
+      type: 'string',
+      description: 'Symbol filter'
+    },
+    'filters.tags': {
+      description: 'Tag filters',
+      type: 'array',
+      items: {
+        type: 'string'
+      }
+    },
+    isExperimentalFeatures: {
+      type: 'boolean',
+      description: 'Enable experimental features'
+    },
+    isRestrictedView: {
+      type: 'boolean',
+      description: 'Enable restricted view mode'
+    },
+    language: {
+      type: 'string',
+      description: 'Language code',
+      example: 'en'
+    },
+    locale: {
+      type: 'string',
+      description: 'Locale code',
+      example: 'en-US'
+    },
+    projectedTotalAmount: {
+      type: 'number',
+      description: 'Projected total amount',
+      example: 1000000
+    },
+    retirementDate: {
+      type: 'string',
+      description: 'Retirement date in ISO 8601 format',
+      example: '2050-01-01'
+    },
+    savingsRate: {
+      type: 'number',
+      description: 'Savings rate percentage',
+      example: 0.2
+    },
+    viewMode: {
+      type: 'string',
+      description: 'View mode',
+      enum: ['DEFAULT', 'ZEN']
+    }
+  }
+} as const;
+
+export const $UpdatePropertyDto = {
+  type: 'object',
+  properties: {
+    value: {
+      type: 'string',
+      description: 'Property value'
+    }
+  },
+  required: ['value']
+} as const;
+
+export const $CreateTransactionRuleDto = {
+  type: 'object',
+  properties: {
+    name: {
+      type: 'string',
+      minLength: 1,
+      maxLength: 100
+    },
+    description: {
+      type: 'string',
+      maxLength: 500
+    },
+    narrationKeywords: {
+      items: {
+        type: 'array'
+      },
+      maxItems: 50,
+      type: 'array'
+    },
+    payeeKeywords: {
+      items: {
+        type: 'array'
+      },
+      maxItems: 50,
       type: 'array'
     },
     categoryKeywords: {
@@ -4133,321 +4856,425 @@ export const $TestRuleDto = {
       maxLength: 10
     }
   },
-  required: ['narration']
+  required: ['narration']
+} as const;
+
+export const $TestRuleResponseDto = {
+  type: 'object',
+  properties: {
+    ruleId: {
+      type: 'string',
+      description: 'Rule ID that was tested'
+    },
+    matches: {
+      type: 'boolean',
+      description: 'Whether the rule matched the test data'
+    },
+    confidence: {
+      type: 'number',
+      description: 'Match confidence score (0-1)',
+      example: 0.85
+    },
+    matchDetails: {
+      type: 'object',
+      description: 'Details of which fields matched',
+      example: {
+        narration: true,
+        payee: false,
+        categoryAccount: false
+      }
+    }
+  },
+  required: ['ruleId', 'matches', 'confidence', 'matchDetails']
+} as const;
+
+export const $CreateBeanEventDto = {
+  type: 'object',
+  properties: {
+    date: {
+      type: 'string',
+      description: 'Life event date (ISO 8601)',
+      example: '2024-03-15'
+    },
+    type: {
+      type: 'string',
+      description:
+        'Life event type (e.g., "employer", "location", "marital-status") — user-defined, no enum constraint at engine layer',
+      example: 'employer'
+    },
+    description: {
+      type: 'string',
+      description:
+        'Life event description. Empty string is a VALID value (distinct from absence).',
+      example: 'Acme Corp'
+    },
+    meta: {
+      type: 'object',
+      description:
+        'Product-side metadata (lives in BeanEvent.meta JSON, never in engine Event fields)',
+      example: {
+        note: 'Promotion'
+      }
+    }
+  },
+  required: ['date', 'type', 'description']
 } as const;
 
-export const $TestRuleResponseDto = {
+export const $EventResponseDto = {
   type: 'object',
   properties: {
-    ruleId: {
+    id: {
       type: 'string',
-      description: 'Rule ID that was tested'
+      description: 'Unique identifier',
+      example: 'uuid-123-456'
     },
-    matches: {
-      type: 'boolean',
-      description: 'Whether the rule matched the test data'
+    userId: {
+      type: 'string',
+      description: 'User ID (owner of the life event)',
+      example: 'user-123'
     },
-    confidence: {
-      type: 'number',
-      description: 'Match confidence score (0-1)',
-      example: 0.85
+    date: {
+      type: 'string',
+      description: 'Life event date (ISO 8601 format)',
+      example: '2024-03-15',
+      format: 'date'
     },
-    matchDetails: {
+    type: {
+      type: 'string',
+      description:
+        'Life event type (user-defined, e.g., "employer", "location")',
+      example: 'employer'
+    },
+    description: {
+      type: 'string',
+      description:
+        'Life event description. May be an empty string (a valid value distinct from absence).',
+      example: 'Acme Corp'
+    },
+    meta: {
       type: 'object',
-      description: 'Details of which fields matched',
+      description: 'Product-side metadata (free-form JSON)',
       example: {
-        narration: true,
-        payee: false,
-        categoryAccount: false
+        note: 'Promotion'
       }
+    },
+    createdAt: {
+      format: 'date-time',
+      type: 'string',
+      description: 'Creation timestamp',
+      example: '2024-03-15T10:00:00Z'
+    },
+    updatedAt: {
+      format: 'date-time',
+      type: 'string',
+      description:
+        'Last update timestamp. Also emitted as the ETag response header for If-Match optimistic concurrency.',
+      example: '2024-03-15T10:00:00Z'
     }
   },
-  required: ['ruleId', 'matches', 'confidence', 'matchDetails']
+  required: [
+    'id',
+    'userId',
+    'date',
+    'type',
+    'description',
+    'meta',
+    'createdAt',
+    'updatedAt'
+  ]
 } as const;
 
-export const $DeleteOwnUserDto = {
+export const $EventListResponseDto = {
   type: 'object',
   properties: {
-    accessToken: {
-      type: 'string',
-      description: 'Access token for user verification',
-      example: 'abc123xyz'
+    items: {
+      description: 'List of life events',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/EventResponseDto'
+      }
+    },
+    total: {
+      type: 'number',
+      description: 'Total number of life events matching the query',
+      example: 42
     }
   },
-  required: ['accessToken']
+  required: ['items', 'total']
 } as const;
 
-export const $SignupDto = {
+export const $UpdateBeanEventDto = {
   type: 'object',
   properties: {
-    turnstileToken: {
+    date: {
+      type: 'string',
+      description: 'Life event date (ISO 8601)'
+    },
+    type: {
+      type: 'string',
+      description: 'Life event type (user-defined)'
+    },
+    description: {
       type: 'string',
       description:
-        'Cloudflare Turnstile verification token (optional when Turnstile disabled)',
-      example: '0.abc123def456...'
+        'Life event description. Empty string is a VALID value (distinct from absence).'
+    },
+    meta: {
+      type: 'object',
+      description: 'Product-side metadata (free-form JSON)'
     }
   }
 } as const;
 
-export const $UpdateUserSettingDto = {
+export const $OnboardingAccountDto = {
   type: 'object',
   properties: {
-    secId: {
-      type: 'number',
-      description: 'Security ID'
-    },
-    annualInterestRate: {
-      type: 'number',
-      description: 'Annual interest rate',
-      example: 0.05
-    },
-    currency: {
+    path: {
       type: 'string',
-      description: 'Currency code',
-      example: 'USD'
+      description:
+        'Account path (Assets/Liabilities only; format validated by the account service)',
+      example: 'Assets:Checking'
     },
-    baseCurrency: {
+    currency: {
       type: 'string',
-      description: 'Base currency code',
+      description: 'ISO 4217 currency code (3 letters)',
       example: 'USD'
     },
-    benchmark: {
-      type: 'string',
-      description: 'Benchmark symbol',
-      example: 'SPY'
-    },
-    colorScheme: {
-      type: 'string',
-      description: 'Color scheme',
-      enum: ['DARK', 'LIGHT']
-    },
-    dateRange: {
-      type: 'string',
-      description: 'Date range filter',
-      example: '1y'
-    },
-    emergencyFund: {
-      type: 'number',
-      description: 'Emergency fund amount',
-      example: 10000
-    },
-    'filters.accounts': {
-      description: 'Account filter IDs',
-      type: 'array',
-      items: {
-        type: 'string'
-      }
-    },
-    'filters.assetClasses': {
-      description: 'Asset class filters',
-      type: 'array',
-      items: {
-        type: 'string'
-      }
-    },
-    'filters.dataSource': {
+    openingBalance: {
       type: 'string',
-      description: 'Data source filter'
+      description:
+        'Opening balance as a non-negative Decimal string (e.g. "1000.00")',
+      example: '1000.00'
     },
-    'filters.symbol': {
+    platformId: {
       type: 'string',
-      description: 'Symbol filter'
-    },
-    'filters.tags': {
-      description: 'Tag filters',
+      description:
+        'Platform ID to bind the account to (references Platform.id); omit for unbound',
+      example: 'c98e5d4a-2f71-4a5a-bb3c-92c9f231d5e2'
+    }
+  },
+  required: ['path', 'currency']
+} as const;
+
+export const $OnboardingDto = {
+  type: 'object',
+  properties: {
+    accounts: {
+      description: 'Asset/Liability accounts to register with opening balances',
       type: 'array',
       items: {
-        type: 'string'
+        $ref: '#/components/schemas/OnboardingAccountDto'
       }
     },
-    isExperimentalFeatures: {
-      type: 'boolean',
-      description: 'Enable experimental features'
-    },
-    isRestrictedView: {
+    skipAssetRegistration: {
       type: 'boolean',
-      description: 'Enable restricted view mode'
-    },
-    language: {
+      description:
+        'Skip asset registration; only bootstrap the core account set',
+      default: false
+    }
+  }
+} as const;
+
+export const $ActualBalanceDto = {
+  type: 'object',
+  properties: {
+    amount: {
       type: 'string',
-      description: 'Language code',
-      example: 'en'
+      description:
+        'Actual balance amount as a decimal string (preserves precision for tolerance inference).',
+      example: '1234.56'
     },
-    locale: {
+    ccy: {
       type: 'string',
-      description: 'Locale code',
-      example: 'en-US'
-    },
-    projectedTotalAmount: {
-      type: 'number',
-      description: 'Projected total amount',
-      example: 1000000
-    },
-    retirementDate: {
+      description: 'Currency code (ISO 4217 or commodity ticker).',
+      example: 'CNY'
+    }
+  },
+  required: ['amount', 'ccy']
+} as const;
+
+export const $ComputeReconciliationDto = {
+  type: 'object',
+  properties: {
+    accountId: {
       type: 'string',
-      description: 'Retirement date in ISO 8601 format',
-      example: '2050-01-01'
-    },
-    savingsRate: {
-      type: 'number',
-      description: 'Savings rate percentage',
-      example: 0.2
+      description: 'BeanAccount id to reconcile.'
     },
-    viewMode: {
+    asOfDate: {
       type: 'string',
-      description: 'View mode',
-      enum: ['DEFAULT', 'ZEN']
+      description: 'Assertion date (ISO 8601, e.g. "2026-07-24").',
+      example: '2026-07-24'
+    },
+    actualBalance: {
+      description: 'Actual balance from the external statement.',
+      allOf: [
+        {
+          $ref: '#/components/schemas/ActualBalanceDto'
+        }
+      ]
     }
-  }
+  },
+  required: ['accountId', 'asOfDate', 'actualBalance']
 } as const;
 
-export const $UpdatePropertyDto = {
+export const $ReconciliationComputeResultDto = {
   type: 'object',
   properties: {
-    value: {
+    accountId: {
+      type: 'string'
+    },
+    asOfDate: {
+      type: 'string'
+    },
+    bookBalance: {
+      type: 'string',
+      description: 'System-computed book balance (decimal string).'
+    },
+    actualBalance: {
+      type: 'string',
+      description: 'User-entered actual balance (decimal string).'
+    },
+    currency: {
+      type: 'string'
+    },
+    diff: {
       type: 'string',
-      description: 'Property value'
+      description: 'Diff = book − actual (decimal string).'
+    },
+    tolerance: {
+      type: 'string',
+      description: 'Applied tolerance (decimal string).'
+    },
+    withinTolerance: {
+      type: 'boolean',
+      description: 'true when |diff| ≤ tolerance.'
+    },
+    suggestedAction: {
+      type: 'string',
+      enum: ['assert', 'pad'],
+      description:
+        'Suggested next action: assert when within tolerance, pad otherwise.'
     }
   },
-  required: ['value']
+  required: [
+    'accountId',
+    'asOfDate',
+    'bookBalance',
+    'actualBalance',
+    'currency',
+    'diff',
+    'tolerance',
+    'withinTolerance',
+    'suggestedAction'
+  ]
 } as const;
 
-export const $CreateBeanEventDto = {
+export const $AssertReconciliationDto = {
   type: 'object',
   properties: {
-    date: {
+    accountId: {
       type: 'string',
-      description: 'Life event date (ISO 8601)',
-      example: '2024-03-15'
+      description: 'BeanAccount id to reconcile.'
     },
-    type: {
+    asOfDate: {
       type: 'string',
-      description:
-        'Life event type (e.g., "employer", "location", "marital-status") — user-defined, no enum constraint at engine layer',
-      example: 'employer'
+      description: 'Assertion date (ISO 8601, e.g. "2026-07-24").',
+      example: '2026-07-24'
     },
-    description: {
-      type: 'string',
-      description:
-        'Life event description. Empty string is a VALID value (distinct from absence).',
-      example: 'Acme Corp'
+    actualBalance: {
+      description: 'Actual balance from the external statement.',
+      allOf: [
+        {
+          $ref: '#/components/schemas/ActualBalanceDto'
+        }
+      ]
     },
-    meta: {
-      type: 'object',
+    tolerance: {
+      type: 'string',
       description:
-        'Product-side metadata (lives in BeanEvent.meta JSON, never in engine Event fields)',
-      example: {
-        note: 'Promotion'
-      }
+        'Optional explicit tolerance override. Omit to infer from amount precision (Beancount default).',
+      example: '0.01'
     }
   },
-  required: ['date', 'type', 'description']
+  required: ['accountId', 'asOfDate', 'actualBalance']
 } as const;
 
-export const $EventResponseDto = {
+export const $ReconciliationRecordDto = {
   type: 'object',
   properties: {
     id: {
-      type: 'string',
-      description: 'Unique identifier',
-      example: 'uuid-123-456'
+      type: 'string'
     },
-    userId: {
-      type: 'string',
-      description: 'User ID (owner of the life event)',
-      example: 'user-123'
+    accountId: {
+      type: 'string'
     },
     date: {
-      type: 'string',
-      description: 'Life event date (ISO 8601 format)',
-      example: '2024-03-15',
-      format: 'date'
+      type: 'string'
     },
-    type: {
+    amount: {
       type: 'string',
-      description:
-        'Life event type (user-defined, e.g., "employer", "location")',
-      example: 'employer'
+      description: 'Asserted (actual) amount.'
     },
-    description: {
-      type: 'string',
-      description:
-        'Life event description. May be an empty string (a valid value distinct from absence).',
-      example: 'Acme Corp'
+    currency: {
+      type: 'string'
     },
-    meta: {
-      type: 'object',
-      description: 'Product-side metadata (free-form JSON)',
-      example: {
-        note: 'Promotion'
-      }
+    tolerance: {
+      type: 'string'
     },
-    createdAt: {
-      format: 'date-time',
+    diffAmount: {
       type: 'string',
-      description: 'Creation timestamp',
-      example: '2024-03-15T10:00:00Z'
+      description: 'book − actual.'
     },
-    updatedAt: {
-      format: 'date-time',
-      type: 'string',
-      description:
-        'Last update timestamp. Also emitted as the ETag response header for If-Match optimistic concurrency.',
-      example: '2024-03-15T10:00:00Z'
+    diffCurrency: {
+      type: 'string'
+    },
+    createdAt: {
+      type: 'string'
     }
   },
-  required: [
-    'id',
-    'userId',
-    'date',
-    'type',
-    'description',
-    'meta',
-    'createdAt',
-    'updatedAt'
-  ]
+  required: ['id', 'accountId', 'date', 'amount', 'currency', 'createdAt']
 } as const;
 
-export const $EventListResponseDto = {
+export const $PadReconciliationDto = {
   type: 'object',
   properties: {
-    items: {
-      description: 'List of life events',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/EventResponseDto'
-      }
+    accountId: {
+      type: 'string',
+      description: 'BeanAccount id to reconcile.'
     },
-    total: {
-      type: 'number',
-      description: 'Total number of life events matching the query',
-      example: 42
+    asOfDate: {
+      type: 'string',
+      description: 'Assertion date (ISO 8601, e.g. "2026-07-24").',
+      example: '2026-07-24'
+    },
+    actualBalance: {
+      description: 'Actual balance from the external statement.',
+      allOf: [
+        {
+          $ref: '#/components/schemas/ActualBalanceDto'
+        }
+      ]
+    },
+    sourceAccount: {
+      type: 'string',
+      description:
+        'Pad source account. Defaults to Equity:Opening-Balances (official Beancount convention).',
+      example: 'Equity:Opening-Balances',
+      default: 'Equity:Opening-Balances'
     }
   },
-  required: ['items', 'total']
+  required: ['accountId', 'asOfDate', 'actualBalance']
 } as const;
 
-export const $UpdateBeanEventDto = {
+export const $PadResultDto = {
   type: 'object',
   properties: {
-    date: {
-      type: 'string',
-      description: 'Life event date (ISO 8601)'
-    },
-    type: {
-      type: 'string',
-      description: 'Life event type (user-defined)'
-    },
-    description: {
+    transactionId: {
       type: 'string',
-      description:
-        'Life event description. Empty string is a VALID value (distinct from absence).'
-    },
-    meta: {
-      type: 'object',
-      description: 'Product-side metadata (free-form JSON)'
+      description: 'Created pad adjusting transaction id.'
     }
-  }
+  },
+  required: ['transactionId']
 } as const;
 
 export const $FileImportDto = {
@@ -4616,7 +5443,7 @@ export const $IdentifyResultDto = {
     account: {
       type: 'string',
       description: 'Default account used by this importer',
-      example: 'Assets:Alipay:Balance'
+      example: 'Assets:CN:Alipay:Balance'
     },
     message: {
       type: 'string',
@@ -4633,7 +5460,7 @@ export const $MapperDefaultsDto = {
     sourceAccount: {
       type: 'string',
       description: 'Source account for transactions (Beancount format)',
-      example: 'Assets:Alipay:Balance'
+      example: 'Assets:CN:Alipay:Balance'
     },
     currency: {
       type: 'string',
@@ -4670,7 +5497,7 @@ export const $MapperDefaultsDto = {
       description:
         'Payment method to source account mapping. Maps payment method keywords to Beancount account paths. Used by Alipay/WeChat importers to determine sourceAccount based on payment method (e.g., HuaBei, CreditCard).',
       example: {
-        HuaBei: 'Liabilities:Alipay:Huabei',
+        HuaBei: 'Liabilities:CN:CreditLine',
         CreditCard: 'Liabilities:CreditCard'
       }
     }
@@ -4802,7 +5629,7 @@ export const $UpdateMapperDefaultsDto = {
     sourceAccount: {
       type: 'string',
       description: 'Source account for transactions (Beancount format)',
-      example: 'Assets:Alipay:Balance',
+      example: 'Assets:CN:Alipay:Balance',
       pattern: '^[A-Z][a-zA-Z0-9-]*:[a-zA-Z0-9-:]+$'
     },
     currency: {
@@ -4830,7 +5657,7 @@ export const $UpdateMapperDefaultsDto = {
       description:
         'Payment method to source account mapping. Maps payment method keywords to Beancount account paths. Used by Alipay/WeChat importers to determine sourceAccount based on payment method (e.g., HuaBei, CreditCard).',
       example: {
-        HuaBei: 'Liabilities:Alipay:Huabei',
+        HuaBei: 'Liabilities:CN:CreditLine',
         CreditCard: 'Liabilities:CreditCard'
       }
     }
@@ -4855,118 +5682,12 @@ export const $UpdateImporterConfigDto = {
   type: 'object',
   properties: {
     data: {
-      description: 'Configuration data (v1 schema)',
-      allOf: [
-        {
-          $ref: '#/components/schemas/UpdateConfigDataDto'
-        }
-      ]
-    }
-  }
-} as const;
-
-export const $CreatePlatformDto = {
-  type: 'object',
-  properties: {
-    name: {
-      type: 'string',
-      description: 'Platform name',
-      example: 'Binance'
-    },
-    canonical: {
-      type: 'string',
-      description: 'Platform canonical identifier (lowercase, kebab-case)',
-      example: 'binance'
-    },
-    aliases: {
-      description: 'Platform aliases (multi-language names for lookup)',
-      example: ['Binance', 'Binance Exchange', 'BNB'],
-      type: 'array',
-      items: {
-        type: 'string'
-      }
-    },
-    url: {
-      type: 'string',
-      description: 'Platform URL',
-      example: 'https://www.binance.com'
-    },
-    type: {
-      type: 'string',
-      description: 'Platform type',
-      enum: [
-        'BANK',
-        'BROKERAGE',
-        'CRYPTO_EXCHANGE',
-        'PAYMENT',
-        'INVESTMENT',
-        'INSURANCE',
-        'OTHER'
-      ],
-      example: 'CRYPTO_EXCHANGE'
-    },
-    logoUrl: {
-      type: 'string',
-      description: 'Platform logo URL',
-      example: 'https://example.com/logos/binance.png'
-    },
-    isActive: {
-      type: 'boolean',
-      description: 'Whether the platform is active',
-      default: true
-    }
-  },
-  required: ['name', 'canonical', 'aliases', 'url', 'type']
-} as const;
-
-export const $UpdatePlatformDto = {
-  type: 'object',
-  properties: {
-    name: {
-      type: 'string',
-      description: 'Platform name',
-      example: 'Binance'
-    },
-    canonical: {
-      type: 'string',
-      description: 'Platform canonical identifier (lowercase, kebab-case)',
-      example: 'binance'
-    },
-    aliases: {
-      description: 'Platform aliases (multi-language names for lookup)',
-      example: ['Binance', 'Binance Exchange', 'BNB'],
-      type: 'array',
-      items: {
-        type: 'string'
-      }
-    },
-    url: {
-      type: 'string',
-      description: 'Platform URL',
-      example: 'https://www.binance.com'
-    },
-    type: {
-      type: 'string',
-      description: 'Platform type',
-      enum: [
-        'BANK',
-        'BROKERAGE',
-        'CRYPTO_EXCHANGE',
-        'PAYMENT',
-        'INVESTMENT',
-        'INSURANCE',
-        'OTHER'
-      ],
-      example: 'CRYPTO_EXCHANGE'
-    },
-    logoUrl: {
-      type: 'string',
-      description: 'Platform logo URL',
-      example: 'https://example.com/logos/binance.png'
-    },
-    isActive: {
-      type: 'boolean',
-      description: 'Whether the platform is active'
+      description: 'Configuration data (v1 schema)',
+      allOf: [
+        {
+          $ref: '#/components/schemas/UpdateConfigDataDto'
+        }
+      ]
     }
   }
 } as const;
@@ -4977,7 +5698,7 @@ export const $ProviderSyncConfigDto = {
     sourceAccount: {
       type: 'string',
       description: 'Source account for the first posting',
-      example: 'Assets:Bank:Chase'
+      example: 'Assets:US:Chase:Checking'
     },
     defaultCurrency: {
       type: 'string',
@@ -4998,6 +5719,12 @@ export const $ProviderSyncConfigDto = {
       type: 'boolean',
       description: 'Filter pending transactions',
       default: true
+    },
+    externalAccountId: {
+      type: 'string',
+      description:
+        'External account ID for per-batch providers (e.g. GoCardless). Overrides sourceAccount when an ExternalAccountLink mapping exists.',
+      example: 'acc_gocardless_001'
     }
   },
   required: [
@@ -5117,6 +5844,94 @@ export const $SupportedProvidersResponseDto = {
   required: ['providers']
 } as const;
 
+export const $CreateExternalAccountLinkDto = {
+  type: 'object',
+  properties: {
+    provider: {
+      type: 'string',
+      enum: [
+        'plaid',
+        'teller',
+        'truelayer',
+        'gocardless',
+        'simplefin',
+        'yodlee',
+        'beancount-direct',
+        'parsed-bill'
+      ],
+      example: 'plaid',
+      description: 'Open Banking provider (whitelist)'
+    },
+    externalAccountId: {
+      type: 'string',
+      example: 'acc-plaid-001',
+      description: 'External account ID from the provider'
+    },
+    beanAccountId: {
+      type: 'string',
+      example: '550e8400-e29b-41d4-a716-446655440000',
+      description: 'Target BeanAccount ID (must belong to the JWT user)'
+    }
+  },
+  required: ['provider', 'externalAccountId', 'beanAccountId']
+} as const;
+
+export const $ExternalAccountLinkResponseDto = {
+  type: 'object',
+  properties: {
+    id: {
+      type: 'string'
+    },
+    provider: {
+      type: 'string'
+    },
+    externalAccountId: {
+      type: 'string'
+    },
+    beanAccountId: {
+      type: 'string'
+    },
+    isActive: {
+      type: 'boolean'
+    },
+    createdAt: {
+      type: 'string'
+    },
+    updatedAt: {
+      type: 'string'
+    }
+  },
+  required: [
+    'id',
+    'provider',
+    'externalAccountId',
+    'beanAccountId',
+    'isActive',
+    'createdAt',
+    'updatedAt'
+  ]
+} as const;
+
+export const $ExternalAccountLinkListResponseDto = {
+  type: 'object',
+  properties: {
+    items: {
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/ExternalAccountLinkResponseDto'
+      }
+    },
+    total: {
+      type: 'number'
+    },
+    provider: {
+      type: 'string',
+      description: 'Filter by provider (query param)'
+    }
+  },
+  required: ['items', 'total']
+} as const;
+
 export const $ParserTelemetryReportDto = {
   type: 'object',
   properties: {}
@@ -5151,6 +5966,18 @@ export const $ProcessNlpDto = {
         currency: 'CNY',
         payee: 'Starbucks'
       }
+    },
+    selectedRuleId: {
+      type: 'string',
+      description:
+        'confirm_rule echo-back: rule id selected from the prior confirm_rule response (matchedRule.id or alternatives[i].ruleId). Applied directly when the session is confirming_rule — no NL re-parse.',
+      example: 'rule_abc123'
+    },
+    selectedAccount: {
+      type: 'string',
+      description:
+        'confirm_account echo-back: account path selected from the prior confirm_account response (suggestedAccount, similarAccounts[i], or a typed path). Applied directly when the session is confirming_account — no NL re-parse.',
+      example: 'Expenses:Food:Coffee'
     }
   },
   required: ['message']
@@ -5475,7 +6302,8 @@ export const $NlpAccountConfirmationDataDto = {
     },
     suggestedAccount: {
       type: 'string',
-      description: 'Suggested replacement account',
+      description:
+        'Suggested replacement account (omitted when no clear candidate)',
       example: 'Expenses:Food:Drinks'
     },
     similarAccounts: {
@@ -5497,7 +6325,6 @@ export const $NlpAccountConfirmationDataDto = {
   },
   required: [
     'invalidAccount',
-    'suggestedAccount',
     'similarAccounts',
     'errorMessage',
     'transactionContext'
@@ -5666,7 +6493,7 @@ export const $NlpSuggestedAccountDto = {
     account: {
       type: 'string',
       description: 'Suggested account path',
-      example: 'Assets:Bank:Checking'
+      example: 'Assets:Checking'
     },
     confidence: {
       type: 'number',
@@ -5707,7 +6534,7 @@ export const $NlpDefaultAccountsDto = {
     asset: {
       type: 'string',
       description: 'Default asset account',
-      example: 'Assets:Bank:Checking'
+      example: 'Assets:Checking'
     },
     expense: {
       type: 'string',
@@ -5747,7 +6574,8 @@ export const $NlpResponseDto = {
         'confirm_rule',
         'confirm_account',
         'confirm_payee',
-        'cancel'
+        'cancel',
+        'aborted'
       ]
     },
     intent: {
@@ -5907,1443 +6735,1526 @@ export const $NlpResponseDto = {
         }
       ]
     },
-    suggestedAccounts: {
-      description:
-        'Suggested accounts for this transaction. Contains recommended source and destination accounts based on the detected intent and rules.',
-      allOf: [
-        {
-          $ref: '#/components/schemas/NlpSuggestedAccountsDto'
-        }
-      ]
-    },
-    defaultAccounts: {
-      description:
-        'Default accounts for the user/region. These are fallback accounts used when no specific suggestion is available.',
-      allOf: [
-        {
-          $ref: '#/components/schemas/NlpDefaultAccountsDto'
-        }
-      ]
-    }
-  },
-  required: ['status', 'action']
-} as const;
-
-export const $BalanceByCurrencyDto = {
-  type: 'object',
-  properties: {
-    currency: {
-      type: 'string',
-      description: 'ISO 4217 currency code',
-      example: 'CNY'
-    },
-    balance: {
-      type: 'string',
-      description: 'Balance amount',
-      example: '50000.00'
-    }
-  },
-  required: ['currency', 'balance']
-} as const;
-
-export const $NetWorthByCurrencyDto = {
-  type: 'object',
-  properties: {
-    netWorth: {
-      description: 'Net worth by currency',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/BalanceByCurrencyDto'
-      }
-    },
-    assets: {
-      description: 'Assets by currency',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/BalanceByCurrencyDto'
-      }
-    },
-    liabilities: {
-      description: 'Liabilities by currency',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/BalanceByCurrencyDto'
-      }
-    }
-  },
-  required: ['netWorth', 'assets', 'liabilities']
-} as const;
-
-export const $ConvertedNetWorthDto = {
-  type: 'object',
-  properties: {
-    baseCurrency: {
-      type: 'string',
-      description: 'Base currency for conversion',
-      example: 'CNY'
-    },
-    netWorth: {
-      type: 'string',
-      description: 'Converted net worth',
-      example: '500000.00'
-    },
-    assets: {
-      type: 'string',
-      description: 'Converted assets',
-      example: '600000.00'
-    },
-    liabilities: {
-      type: 'string',
-      description: 'Converted liabilities',
-      example: '100000.00'
-    },
-    exchangeRates: {
-      type: 'object',
-      description: 'Exchange rates used for conversion',
-      example: {
-        USD: '7.200000',
-        EUR: '7.800000'
-      }
-    }
-  },
-  required: [
-    'baseCurrency',
-    'netWorth',
-    'assets',
-    'liabilities',
-    'exchangeRates'
-  ]
-} as const;
-
-export const $ExchangeRateWarningDto = {
-  type: 'object',
-  properties: {
-    type: {
-      type: 'string',
-      description: 'Warning type',
-      example: 'MISSING_EXCHANGE_RATE'
-    },
-    currency: {
-      type: 'string',
-      description: 'Currency without exchange rate',
-      example: 'EUR'
-    },
-    totalAmount: {
-      type: 'string',
-      description: 'Total amount affected',
-      example: '1000.00'
-    }
-  },
-  required: ['type', 'currency', 'totalAmount']
-} as const;
-
-export const $NetWorthResponseDto = {
-  type: 'object',
-  properties: {
-    netWorth: {
-      type: 'string',
-      description:
-        'Total net worth (assets - liabilities, converted to base currency)',
-      example: '500000.00'
-    },
-    assets: {
-      type: 'string',
-      description: 'Total assets value (converted)',
-      example: '600000.00'
-    },
-    liabilities: {
-      type: 'string',
-      description: 'Total liabilities value (positive number, converted)',
-      example: '100000.00'
-    },
-    monthlyReturn: {
-      type: 'string',
-      description: 'Monthly return (change from last month)',
-      example: '15000.00'
-    },
-    monthlyReturnPercentage: {
-      type: 'string',
-      description: 'Monthly return percentage',
-      example: '3.15'
-    },
-    currency: {
-      type: 'string',
-      description: 'Base currency code',
-      example: 'CNY'
-    },
-    asOf: {
-      type: 'string',
-      description: 'Data as of date (ISO 8601)',
-      example: '2024-06-15T00:00:00.000Z'
-    },
-    byCurrency: {
-      description: 'Balances grouped by original currency',
+    suggestedAccounts: {
+      description:
+        'Suggested accounts for this transaction. Contains recommended source and destination accounts based on the detected intent and rules.',
       allOf: [
         {
-          $ref: '#/components/schemas/NetWorthByCurrencyDto'
+          $ref: '#/components/schemas/NlpSuggestedAccountsDto'
         }
       ]
     },
-    converted: {
+    defaultAccounts: {
       description:
-        'Converted values in base currency (undefined if no exchange rates available)',
+        'Default accounts for the user/region. These are fallback accounts used when no specific suggestion is available.',
       allOf: [
         {
-          $ref: '#/components/schemas/ConvertedNetWorthDto'
+          $ref: '#/components/schemas/NlpDefaultAccountsDto'
         }
       ]
-    },
-    warnings: {
-      description: 'Exchange rate warnings',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/ExchangeRateWarningDto'
-      }
     }
   },
-  required: [
-    'netWorth',
-    'assets',
-    'liabilities',
-    'monthlyReturn',
-    'monthlyReturnPercentage',
-    'currency',
-    'asOf'
-  ]
+  required: ['status', 'action']
 } as const;
 
-export const $AccountItemDto = {
+export const $PlatformListItemDto = {
   type: 'object',
   properties: {
     id: {
       type: 'string',
-      description: 'Account ID'
+      description: 'Global platform ID'
     },
     name: {
       type: 'string',
-      description: 'Full account name',
-      example: 'Assets:Bank:CMB:Savings'
+      description: 'Platform name'
     },
-    displayName: {
+    url: {
       type: 'string',
-      description: 'Display name (last part of account path)',
-      example: 'Savings'
+      description: 'Platform URL'
     },
-    balance: {
+    type: {
       type: 'string',
-      description: 'Account balance',
-      example: '50000.00'
+      description: 'Platform type',
+      enum: [
+        'BANK',
+        'BROKERAGE',
+        'CRYPTO_EXCHANGE',
+        'PAYMENT',
+        'INVESTMENT',
+        'INSURANCE',
+        'OTHER'
+      ]
     },
-    currency: {
+    canonical: {
       type: 'string',
-      description: 'Currency code',
-      example: 'CNY'
+      description: 'Canonical identifier in ACCOUNT_RE format (e.g., "icbc")'
+    },
+    suggestedSegment: {
+      type: 'string',
+      description:
+        'Suggested path segment — canonical with first char uppercased (ACC_COMP_NAME_RE)'
+    },
+    logoUrl: {
+      type: 'string',
+      description: 'Logo URL',
+      nullable: true
+    },
+    isBound: {
+      type: 'boolean',
+      description: 'Whether user has accounts using this platform'
     }
   },
-  required: ['id', 'name', 'displayName', 'balance', 'currency']
+  required: [
+    'id',
+    'name',
+    'url',
+    'type',
+    'canonical',
+    'suggestedSegment',
+    'logoUrl',
+    'isBound'
+  ]
 } as const;
 
-export const $PlatformGroupDto = {
+export const $PlatformMatchResultDto = {
   type: 'object',
   properties: {
-    platformId: {
+    id: {
       type: 'string',
-      description: 'Platform ID'
+      description: 'Global platform ID'
     },
-    platformName: {
+    name: {
       type: 'string',
-      description: 'Platform display name',
-      example: 'CMB Bank'
+      description: 'Platform name (e.g., "ICBC")'
     },
-    accounts: {
-      description: 'Accounts within this platform',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/AccountItemDto'
-      }
+    canonical: {
+      type: 'string',
+      description: 'Canonical identifier in ACCOUNT_RE format (e.g., "icbc")'
     },
-    totalBalance: {
+    type: {
       type: 'string',
-      description: 'Total balance across all accounts in platform',
-      example: '100000.00'
-    }
-  },
-  required: ['platformId', 'platformName', 'accounts', 'totalBalance']
-} as const;
-
-export const $AccountsSummaryDto = {
-  type: 'object',
-  properties: {
-    totalAccounts: {
-      type: 'number',
-      description: 'Total number of accounts'
+      description: 'Platform type',
+      enum: [
+        'BANK',
+        'BROKERAGE',
+        'CRYPTO_EXCHANGE',
+        'PAYMENT',
+        'INVESTMENT',
+        'INSURANCE',
+        'OTHER'
+      ]
     },
-    totalPlatforms: {
-      type: 'number',
-      description: 'Total number of platforms'
+    suggestedSegment: {
+      type: 'string',
+      description:
+        'Suggested path segment — canonical, already in ACCOUNT_RE format'
+    },
+    logoUrl: {
+      type: 'string',
+      description: 'Logo URL',
+      nullable: true
+    },
+    matchType: {
+      type: 'string',
+      description: "How this row matched: 'exact' > 'prefix' > 'substring'",
+      enum: ['exact', 'prefix', 'substring']
     }
   },
-  required: ['totalAccounts', 'totalPlatforms']
+  required: [
+    'id',
+    'name',
+    'canonical',
+    'type',
+    'suggestedSegment',
+    'logoUrl',
+    'matchType'
+  ]
 } as const;
 
-export const $AccountsResponseDto = {
+export const $PlatformMatchResponseDto = {
   type: 'object',
   properties: {
-    groups: {
-      description: 'Account groups by platform',
+    platforms: {
+      description: 'Ranked matches, best tier first (at most 10 rows)',
       type: 'array',
       items: {
-        $ref: '#/components/schemas/PlatformGroupDto'
+        $ref: '#/components/schemas/PlatformMatchResultDto'
       }
     },
-    summary: {
-      description: 'Summary statistics',
-      allOf: [
-        {
-          $ref: '#/components/schemas/AccountsSummaryDto'
-        }
-      ]
+    matchType: {
+      type: 'string',
+      description:
+        "Overall match quality — top row's tier, or 'none' when no hits",
+      enum: ['none', 'exact', 'prefix', 'substring']
+    },
+    total: {
+      type: 'number',
+      description: 'Total matches before LIMIT (truncation transparency)'
+    },
+    hasMore: {
+      type: 'boolean',
+      description: 'true when total > platforms.length (more matches exist)'
     }
   },
-  required: ['groups', 'summary']
+  required: ['platforms', 'matchType', 'total', 'hasMore']
 } as const;
 
-export const $AccountItemWithAssetClassDto = {
+export const $CreatePlatformDto = {
   type: 'object',
   properties: {
-    id: {
+    name: {
       type: 'string',
-      description: 'Account ID'
+      description: 'Platform name',
+      example: 'Binance'
     },
-    name: {
+    canonical: {
       type: 'string',
-      description: 'Full account name',
-      example: 'Assets:Bank:CMB:Savings'
+      description: 'Platform canonical identifier (lowercase, kebab-case)',
+      example: 'binance'
     },
-    displayName: {
+    aliases: {
+      description: 'Platform aliases (multi-language names for lookup)',
+      example: ['Binance', 'Binance Exchange', 'BNB'],
+      type: 'array',
+      items: {
+        type: 'string'
+      }
+    },
+    url: {
       type: 'string',
-      description: 'Display name (last part of account path)',
-      example: 'Savings'
+      description: 'Platform URL',
+      example: 'https://www.binance.com'
     },
-    balance: {
+    type: {
       type: 'string',
-      description: 'Account balance',
-      example: '50000.00'
+      description: 'Platform type',
+      enum: [
+        'BANK',
+        'BROKERAGE',
+        'CRYPTO_EXCHANGE',
+        'PAYMENT',
+        'INVESTMENT',
+        'INSURANCE',
+        'OTHER'
+      ],
+      example: 'CRYPTO_EXCHANGE'
     },
-    currency: {
+    logoUrl: {
       type: 'string',
-      description: 'Currency code',
-      example: 'CNY'
+      description: 'Platform logo URL',
+      example: 'https://example.com/logos/binance.png'
     },
-    assetClass: {
+    isActive: {
+      type: 'boolean',
+      description: 'Whether the platform is active',
+      default: true
+    }
+  },
+  required: ['name', 'canonical', 'aliases', 'url', 'type']
+} as const;
+
+export const $UpdatePlatformDto = {
+  type: 'object',
+  properties: {
+    name: {
       type: 'string',
-      description: 'Asset class',
-      example: 'LIQUIDITY'
+      description: 'Platform name',
+      example: 'Binance'
     },
-    assetSubClass: {
+    canonical: {
       type: 'string',
-      description: 'Asset sub-class (Prisma-compatible)',
-      example: 'RETIREMENT_ACCOUNT'
+      description: 'Platform canonical identifier (lowercase, kebab-case)',
+      example: 'binance'
     },
-    regionalSubClass: {
+    aliases: {
+      description: 'Platform aliases (multi-language names for lookup)',
+      example: ['Binance', 'Binance Exchange', 'BNB'],
+      type: 'array',
+      items: {
+        type: 'string'
+      }
+    },
+    url: {
       type: 'string',
-      description: 'Regional sub-class (region-specific, for display)',
-      example: 'FOUR_ZERO_ONE_K'
+      description: 'Platform URL',
+      example: 'https://www.binance.com'
     },
-    riskLevel: {
+    type: {
       type: 'string',
-      description: 'Risk level',
-      example: 'LOW'
+      description: 'Platform type',
+      enum: [
+        'BANK',
+        'BROKERAGE',
+        'CRYPTO_EXCHANGE',
+        'PAYMENT',
+        'INVESTMENT',
+        'INSURANCE',
+        'OTHER'
+      ],
+      example: 'CRYPTO_EXCHANGE'
     },
-    source: {
+    logoUrl: {
       type: 'string',
-      description:
-        'ADR-0105 classification provenance (holding level always; account level only on FALLBACK)',
-      enum: ['USER_META', 'FIAT_CURRENCY', 'OPENBB_MAPPING', 'FALLBACK']
+      description: 'Platform logo URL',
+      example: 'https://example.com/logos/binance.png'
+    },
+    isActive: {
+      type: 'boolean',
+      description: 'Whether the platform is active'
     }
-  },
-  required: ['id', 'name', 'displayName', 'balance', 'currency', 'assetClass']
+  }
 } as const;
 
-export const $AssetClassGroupDto = {
+export const $NetWorthByCurrencyDto = {
   type: 'object',
   properties: {
-    assetClass: {
-      type: 'string',
-      description: 'Asset class name',
-      example: 'LIQUIDITY',
-      enum: [
-        'LIQUIDITY',
-        'EQUITY',
-        'FIXED_INCOME',
-        'PRECIOUS_METALS',
-        'COMMODITY',
-        'INSURANCE',
-        'ALTERNATIVE_INVESTMENT',
-        'PERSONAL_ASSETS',
-        'LIABILITY',
-        'REAL_ESTATE',
-        'INDEX'
-      ]
-    },
-    assetSubClass: {
-      type: 'string',
-      description: 'Asset sub-class name',
-      example: 'DEPOSIT'
-    },
-    accounts: {
-      description: 'Accounts within this asset class',
+    netWorth: {
+      description: 'Net worth by currency',
       type: 'array',
       items: {
-        $ref: '#/components/schemas/AccountItemWithAssetClassDto'
+        $ref: '#/components/schemas/BalanceByCurrencyDto'
       }
     },
-    balanceByCurrency: {
-      description: 'Balances grouped by currency',
+    assets: {
+      description: 'Assets by currency',
       type: 'array',
       items: {
         $ref: '#/components/schemas/BalanceByCurrencyDto'
       }
     },
-    convertedBalance: {
-      type: 'string',
-      description: 'Converted balance in base currency',
-      example: '100000.00'
+    liabilities: {
+      description: 'Liabilities by currency',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/BalanceByCurrencyDto'
+      }
     }
   },
-  required: ['assetClass', 'accounts', 'balanceByCurrency']
+  required: ['netWorth', 'assets', 'liabilities']
 } as const;
 
-export const $AccountExchangeRateWarningDto = {
+export const $ConvertedNetWorthDto = {
   type: 'object',
   properties: {
-    type: {
+    baseCurrency: {
       type: 'string',
-      description: 'Warning type',
-      example: 'MISSING_EXCHANGE_RATE'
+      description: 'Base currency for conversion',
+      example: 'CNY'
     },
-    currency: {
+    netWorth: {
       type: 'string',
-      description: 'Currency without exchange rate',
-      example: 'USD'
+      description: 'Converted net worth',
+      example: '500000.00'
     },
-    accounts: {
-      description: 'Affected account paths',
-      type: 'array',
-      items: {
-        type: 'string'
-      }
+    assets: {
+      type: 'string',
+      description: 'Converted assets',
+      example: '600000.00'
     },
-    totalAmount: {
+    liabilities: {
       type: 'string',
-      description: 'Total amount in this currency',
-      example: '5000.00'
+      description: 'Converted liabilities',
+      example: '100000.00'
+    },
+    exchangeRates: {
+      type: 'object',
+      description: 'Exchange rates used for conversion',
+      example: {
+        USD: '7.200000',
+        EUR: '7.800000'
+      }
     }
   },
-  required: ['type', 'currency', 'accounts', 'totalAmount']
+  required: [
+    'baseCurrency',
+    'netWorth',
+    'assets',
+    'liabilities',
+    'exchangeRates'
+  ]
 } as const;
 
-export const $AssetClassSummaryDto = {
+export const $NetWorthResponseDto = {
   type: 'object',
   properties: {
-    totalAccounts: {
-      type: 'number',
-      description: 'Total number of accounts'
+    netWorth: {
+      type: 'string',
+      description:
+        'Total net worth (assets - liabilities, converted to base currency)',
+      example: '500000.00'
     },
-    totalAssetClasses: {
-      type: 'number',
-      description: 'Total number of asset classes'
+    assets: {
+      type: 'string',
+      description: 'Total assets value (converted)',
+      example: '600000.00'
     },
-    baseCurrency: {
+    liabilities: {
       type: 'string',
-      description: 'Base currency for conversion',
-      example: 'CNY'
+      description: 'Total liabilities value (positive number, converted)',
+      example: '100000.00'
     },
-    warnings: {
-      description: 'Exchange rate warnings',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/AccountExchangeRateWarningDto'
-      }
+    monthlyReturn: {
+      type: 'string',
+      description: 'Monthly return (change from last month)',
+      example: '15000.00'
     },
-    fallback: {
-      type: 'object',
-      description:
-        'ADR-0105 §4 fallback provenance stats (holding level only). valueRatio is the grey-area share of total converted value; count is the number of source=FALLBACK holdings.'
-    }
-  },
-  required: ['totalAccounts', 'totalAssetClasses', 'baseCurrency']
-} as const;
-
-export const $AssetClassAccountsResponseDto = {
-  type: 'object',
-  properties: {
-    groups: {
-      description: 'Account groups by asset class',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/AssetClassGroupDto'
-      }
+    monthlyReturnPercentage: {
+      type: 'string',
+      description: 'Monthly return percentage',
+      example: '3.15'
     },
-    summary: {
-      description: 'Summary statistics',
+    currency: {
+      type: 'string',
+      description: 'Base currency code',
+      example: 'CNY'
+    },
+    asOf: {
+      type: 'string',
+      description: 'Data as of date (ISO 8601)',
+      example: '2024-06-15T00:00:00.000Z'
+    },
+    byCurrency: {
+      description: 'Balances grouped by original currency',
       allOf: [
         {
-          $ref: '#/components/schemas/AssetClassSummaryDto'
+          $ref: '#/components/schemas/NetWorthByCurrencyDto'
         }
       ]
     },
-    uncategorized: {
+    converted: {
       description:
-        'ADR-0105 §6 holding-level grey-area bucket (source=FALLBACK holdings peeled out of groups). Present only for groupBy=holdingAssetClass when FALLBACK holdings exist.',
+        'Converted values in base currency (undefined if no exchange rates available)',
       allOf: [
         {
-          $ref: '#/components/schemas/AssetClassGroupDto'
+          $ref: '#/components/schemas/ConvertedNetWorthDto'
         }
       ]
+    },
+    warnings: {
+      description: 'Exchange rate warnings',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/ExchangeRateWarningDto'
+      }
     }
   },
-  required: ['groups', 'summary']
+  required: [
+    'netWorth',
+    'assets',
+    'liabilities',
+    'monthlyReturn',
+    'monthlyReturnPercentage',
+    'currency',
+    'asOf'
+  ]
 } as const;
 
-export const $HoldingAssetClassAccountSliceDto = {
+export const $AccountItemDto = {
   type: 'object',
   properties: {
-    accountId: {
+    id: {
       type: 'string',
       description: 'Account ID'
     },
-    accountPath: {
+    name: {
       type: 'string',
-      description: 'Full account path',
-      example: 'Assets:US:Investments:Brokerage'
+      description: 'Full account name',
+      example: 'Assets:CN:CMB:Savings'
     },
-    accountCurrency: {
+    displayName: {
       type: 'string',
-      description:
-        'Currency of the holding with the largest converted base value; undefined when no holding is convertible',
-      example: 'USD'
+      description: 'Display name (last part of account path)',
+      example: 'Savings'
     },
-    marketValueBase: {
+    balance: {
       type: 'string',
-      description:
-        "Account's market value in base currency (Σ converted holdings; grey bucket included)",
+      description: 'Account balance',
       example: '50000.00'
     },
-    shareOfTotalPct: {
-      type: 'number',
+    currency: {
+      type: 'string',
+      description: 'Currency code',
+      example: 'CNY'
+    },
+    convertedBalance: {
+      type: 'string',
       description:
-        'Share of the global total (0-100). 0 when globalTotal is zero (no NaN/Infinity).',
-      example: 42.5
+        'FX-converted balance in base currency; omitted when not convertible',
+      example: '50000.00'
+    }
+  },
+  required: ['id', 'name', 'displayName', 'balance', 'currency']
+} as const;
+
+export const $PlatformGroupDto = {
+  type: 'object',
+  properties: {
+    platformId: {
+      type: 'string',
+      description: 'Platform ID'
     },
-    groups: {
-      description: 'Per-account asset-class breakdown',
+    platformName: {
+      type: 'string',
+      description: 'Platform display name',
+      example: 'CMB Bank'
+    },
+    accounts: {
+      description: 'Accounts within this platform',
       type: 'array',
       items: {
-        $ref: '#/components/schemas/AssetClassGroupDto'
+        $ref: '#/components/schemas/AccountItemDto'
+      }
+    },
+    totalBalance: {
+      type: 'string',
+      description: 'FX-converted total balance in base currency',
+      example: '100000.00'
+    },
+    balanceByCurrency: {
+      description: 'Raw (unconverted) balances grouped by currency',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/BalanceByCurrencyDto'
       }
     },
-    uncategorized: {
+    convertedBalance: {
+      type: 'string',
       description:
-        'Per-account grey bucket (source=FALLBACK holdings, incl. broker cash)',
-      allOf: [
-        {
-          $ref: '#/components/schemas/AssetClassGroupDto'
-        }
-      ]
+        'Converted balance in base currency (omitted when no currency is convertible)',
+      example: '100000.00'
     },
-    holdings: {
+    sharePct: {
+      type: 'number',
       description:
-        'Every holding row for this account (account ID in each row’s `id` field)',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/AccountItemWithAssetClassDto'
-      }
+        'Share of the grand converted total (0-100); 0 when grand total is 0',
+      example: 42.5
     }
   },
   required: [
-    'accountId',
-    'accountPath',
-    'marketValueBase',
-    'shareOfTotalPct',
-    'groups',
-    'holdings'
+    'platformId',
+    'platformName',
+    'accounts',
+    'totalBalance',
+    'balanceByCurrency',
+    'sharePct'
   ]
 } as const;
 
-export const $HoldingAssetClassCrossAccountResponseDto = {
+export const $AccountExchangeRateWarningDto = {
   type: 'object',
   properties: {
-    global: {
-      description: 'Merged cross-account holding aggregation',
-      allOf: [
-        {
-          $ref: '#/components/schemas/AssetClassAccountsResponseDto'
-        }
-      ]
+    type: {
+      type: 'string',
+      description: 'Warning type',
+      example: 'MISSING_EXCHANGE_RATE'
     },
-    byAccount: {
-      description: 'Per-account slices',
+    currency: {
+      type: 'string',
+      description: 'Currency without exchange rate',
+      example: 'USD'
+    },
+    accounts: {
+      description: 'Affected account paths',
       type: 'array',
       items: {
-        $ref: '#/components/schemas/HoldingAssetClassAccountSliceDto'
+        type: 'string'
       }
+    },
+    totalAmount: {
+      type: 'string',
+      description: 'Total amount in this currency',
+      example: '5000.00'
     }
   },
-  required: ['global', 'byAccount']
+  required: ['type', 'currency', 'accounts', 'totalAmount']
 } as const;
 
-export const $CashFlowByCurrencyDto = {
+export const $AccountsSummaryDto = {
   type: 'object',
   properties: {
-    income: {
-      description: 'Income by currency',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/BalanceByCurrencyDto'
-      }
+    totalAccounts: {
+      type: 'number',
+      description: 'Total number of accounts'
     },
-    expense: {
-      description: 'Expense by currency',
+    totalPlatforms: {
+      type: 'number',
+      description: 'Total number of platforms'
+    },
+    baseCurrency: {
+      type: 'string',
+      description: 'Base currency for conversion',
+      example: 'CNY'
+    },
+    warnings: {
+      description: 'Per-account exchange rate warnings',
       type: 'array',
       items: {
-        $ref: '#/components/schemas/BalanceByCurrencyDto'
+        $ref: '#/components/schemas/AccountExchangeRateWarningDto'
       }
-    },
-    netSavings: {
-      description: 'Net savings by currency',
+    }
+  },
+  required: ['totalAccounts', 'totalPlatforms', 'baseCurrency']
+} as const;
+
+export const $AccountsResponseDto = {
+  type: 'object',
+  properties: {
+    groups: {
+      description: 'Account groups by platform',
       type: 'array',
       items: {
-        $ref: '#/components/schemas/BalanceByCurrencyDto'
+        $ref: '#/components/schemas/PlatformGroupDto'
       }
+    },
+    summary: {
+      description: 'Summary statistics',
+      allOf: [
+        {
+          $ref: '#/components/schemas/AccountsSummaryDto'
+        }
+      ]
     }
   },
-  required: ['income', 'expense', 'netSavings']
+  required: ['groups', 'summary']
 } as const;
 
-export const $ConvertedCashFlowDto = {
+export const $AccountItemWithAssetClassDto = {
   type: 'object',
   properties: {
-    baseCurrency: {
+    id: {
       type: 'string',
-      description: 'Base currency for conversion',
-      example: 'CNY'
+      description: 'Account ID'
     },
-    income: {
+    name: {
       type: 'string',
-      description: 'Converted income',
-      example: '25000.00'
+      description: 'Full account name',
+      example: 'Assets:CN:CMB:Savings'
     },
-    expense: {
+    displayName: {
       type: 'string',
-      description: 'Converted expense',
-      example: '18000.00'
+      description: 'Display name (last part of account path)',
+      example: 'Savings'
     },
-    netSavings: {
+    balance: {
       type: 'string',
-      description: 'Converted net savings',
-      example: '7000.00'
+      description: 'Account balance',
+      example: '50000.00'
     },
-    exchangeRates: {
-      type: 'object',
-      description: 'Exchange rates used for conversion',
-      example: {
-        USD: '7.200000'
-      }
-    }
-  },
-  required: ['baseCurrency', 'income', 'expense', 'netSavings', 'exchangeRates']
-} as const;
-
-export const $CashFlowResponseDto = {
-  type: 'object',
-  properties: {
-    period: {
+    currency: {
       type: 'string',
-      description: 'Period identifier (YYYY-MM)',
-      example: '2024-06'
+      description: 'Currency code',
+      example: 'CNY'
     },
-    income: {
+    convertedBalance: {
       type: 'string',
-      description: 'Total income for the period (converted)',
-      example: '25000.00'
+      description:
+        'FX-converted balance in base currency; omitted when not convertible',
+      example: '50000.00'
     },
-    expense: {
+    assetClass: {
       type: 'string',
-      description: 'Total expenses for the period (converted)',
-      example: '18000.00'
+      description: 'Asset class',
+      example: 'LIQUIDITY'
     },
-    netSavings: {
+    assetSubClass: {
       type: 'string',
-      description: 'Net savings (income - expense, converted)',
-      example: '7000.00'
+      description: 'Asset sub-class (Prisma-compatible)',
+      example: 'RETIREMENT_ACCOUNT'
     },
-    savingsRate: {
+    regionalSubClass: {
       type: 'string',
-      description: 'Savings rate percentage (netSavings / income * 100)',
-      example: '28.00'
+      description: 'Regional sub-class (region-specific, for display)',
+      example: 'FOUR_ZERO_ONE_K'
     },
-    currency: {
+    riskLevel: {
       type: 'string',
-      description: 'Base currency code',
-      example: 'CNY'
-    },
-    byCurrency: {
-      description: 'Cash flow grouped by original currency',
-      allOf: [
-        {
-          $ref: '#/components/schemas/CashFlowByCurrencyDto'
-        }
-      ]
-    },
-    converted: {
-      description: 'Converted values in base currency',
-      allOf: [
-        {
-          $ref: '#/components/schemas/ConvertedCashFlowDto'
-        }
-      ]
+      description: 'Risk level',
+      example: 'LOW'
     },
-    warnings: {
-      description: 'Exchange rate warnings',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/ExchangeRateWarningDto'
-      }
+    source: {
+      type: 'string',
+      description:
+        'ADR-0105 classification provenance (holding level always; account level only on FALLBACK)',
+      enum: ['USER_META', 'FIAT_CURRENCY', 'OPENBB_MAPPING', 'FALLBACK']
     }
   },
-  required: [
-    'period',
-    'income',
-    'expense',
-    'netSavings',
-    'savingsRate',
-    'currency'
-  ]
+  required: ['id', 'name', 'displayName', 'balance', 'currency', 'assetClass']
 } as const;
 
-export const $MonetaryDto = {
+export const $AssetClassGroupDto = {
   type: 'object',
   properties: {
-    amount: {
+    assetClass: {
       type: 'string',
-      description: 'Amount (Decimal string)',
-      example: '3000'
+      description: 'Asset class name',
+      example: 'LIQUIDITY',
+      enum: [
+        'LIQUIDITY',
+        'EQUITY',
+        'FIXED_INCOME',
+        'PRECIOUS_METALS',
+        'COMMODITY',
+        'INSURANCE',
+        'ALTERNATIVE_INVESTMENT',
+        'PERSONAL_ASSETS',
+        'LIABILITY',
+        'REAL_ESTATE',
+        'INDEX'
+      ]
     },
-    currency: {
+    assetSubClass: {
       type: 'string',
-      description: 'ISO 4217 currency',
-      example: 'USD'
+      description: 'Asset sub-class name',
+      example: 'DEPOSIT'
     },
-    baseCcyEquivalent: {
-      type: 'object',
-      description: 'Converted to user base currency (Decimal string)',
-      example: '21600',
-      nullable: true
+    accounts: {
+      description: 'Accounts within this asset class',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/AccountItemWithAssetClassDto'
+      }
+    },
+    balanceByCurrency: {
+      description: 'Balances grouped by currency',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/BalanceByCurrencyDto'
+      }
+    },
+    convertedBalance: {
+      type: 'string',
+      description: 'Converted balance in base currency',
+      example: '100000.00'
     }
   },
-  required: ['amount', 'currency']
+  required: ['assetClass', 'accounts', 'balanceByCurrency']
 } as const;
 
-export const $CurrentPriceDto = {
+export const $AssetClassSummaryDto = {
   type: 'object',
   properties: {
-    amount: {
-      type: 'string',
-      description: 'Price amount (Decimal string)',
-      example: '250'
+    totalAccounts: {
+      type: 'number',
+      description: 'Total number of accounts'
     },
-    currency: {
-      type: 'string',
-      description: 'Price currency (ISO 4217)',
-      example: 'USD'
+    totalAssetClasses: {
+      type: 'number',
+      description: 'Total number of asset classes'
     },
-    date: {
+    baseCurrency: {
       type: 'string',
-      description: 'Price date (ISO 8601)',
-      example: '2024-06-01'
+      description: 'Base currency for conversion',
+      example: 'CNY'
     },
-    source: {
-      type: 'string',
-      description: 'Price source',
-      example: 'USER_OVERRIDE',
-      enum: ['USER_OVERRIDE', 'OPENBB_EQUITY', 'OPENBB_CURRENCY']
+    warnings: {
+      description: 'Exchange rate warnings',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/AccountExchangeRateWarningDto'
+      }
+    },
+    fallback: {
+      type: 'object',
+      description:
+        'ADR-0105 §4 fallback provenance stats (holding level only). valueRatio is the grey-area share of total converted value; count is the number of source=FALLBACK holdings.'
     }
   },
-  required: ['amount', 'currency', 'date', 'source']
+  required: ['totalAccounts', 'totalAssetClasses', 'baseCurrency']
 } as const;
 
-export const $FxRateDto = {
+export const $AssetClassAccountsResponseDto = {
   type: 'object',
   properties: {
-    from: {
-      type: 'string',
-      example: 'USD'
-    },
-    to: {
-      type: 'string',
-      example: 'CNY'
+    groups: {
+      description: 'Account groups by asset class',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/AssetClassGroupDto'
+      }
     },
-    rate: {
-      type: 'string',
-      description: 'FX rate (Decimal string)',
-      example: '7.2'
+    summary: {
+      description: 'Summary statistics',
+      allOf: [
+        {
+          $ref: '#/components/schemas/AssetClassSummaryDto'
+        }
+      ]
     },
-    date: {
-      type: 'string',
-      description: 'Rate date (ISO 8601)',
-      example: '2024-01-15'
+    uncategorized: {
+      description:
+        'ADR-0105 §6 holding-level grey-area bucket (source=FALLBACK holdings peeled out of groups). Present only for groupBy=holdingAssetClass when FALLBACK holdings exist.',
+      allOf: [
+        {
+          $ref: '#/components/schemas/AssetClassGroupDto'
+        }
+      ]
     }
   },
-  required: ['from', 'to', 'rate', 'date']
+  required: ['groups', 'summary']
 } as const;
 
-export const $HoldingPnlRowDto = {
+export const $HoldingAssetClassAccountSliceDto = {
   type: 'object',
   properties: {
     accountId: {
       type: 'string',
-      description: 'Account UUID',
-      example: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
+      description: 'Account ID'
     },
     accountPath: {
       type: 'string',
       description: 'Full account path',
-      example: 'Assets:US:Broker:AAPL'
+      example: 'Assets:US:Fidelity:Brokerage'
     },
-    accountCcy: {
-      type: 'object',
-      description: 'Account settlement currency (ISO 4217), from cost currency',
-      nullable: true,
-      example: 'USD'
-    },
-    brokerType: {
-      type: 'object',
-      description: 'Broker type derived from Platform.type',
-      nullable: true,
-      example: 'broker'
-    },
-    symbol: {
-      type: 'string',
-      description: 'Commodity symbol',
-      example: 'AAPL'
-    },
-    chartToken: {
-      type: 'string',
-      description: 'Chart segment token (libs/common resolver)',
-      example: 'equity',
-      enum: ['equity', 'fund', 'bond', 'cash', 'other']
-    },
-    assetClass: {
+    accountCurrency: {
       type: 'string',
-      example: 'EQUITY'
-    },
-    assetSubClass: {
-      type: 'object',
-      nullable: true,
-      example: 'STOCK'
+      description:
+        'Currency of the holding with the largest converted base value; undefined when no holding is convertible',
+      example: 'USD'
     },
-    units: {
+    marketValueBase: {
       type: 'string',
-      description: 'Net held units (Decimal string)',
-      example: '12'
-    },
-    averageCostPerUnit: {
       description:
-        'Average cost per unit; null when cost currency conflicts or no cost',
-      nullable: true,
-      allOf: [
-        {
-          $ref: '#/components/schemas/MonetaryDto'
-        }
-      ]
-    },
-    costBasis: {
-      description: 'Cost basis of held units',
-      nullable: true,
-      allOf: [
-        {
-          $ref: '#/components/schemas/MonetaryDto'
-        }
-      ]
-    },
-    marketValue: {
-      description: 'Market value at asOf price',
-      nullable: true,
-      allOf: [
-        {
-          $ref: '#/components/schemas/MonetaryDto'
-        }
-      ]
-    },
-    currentPrice: {
-      description: 'Price used for market value',
-      nullable: true,
-      allOf: [
-        {
-          $ref: '#/components/schemas/CurrentPriceDto'
-        }
-      ]
+        "Account's market value in base currency (Σ converted holdings; grey bucket included)",
+      example: '50000.00'
     },
-    unrealizedPnlBase: {
-      type: 'object',
+    shareOfTotalPct: {
+      type: 'number',
       description:
-        'Unrealized P&L in base currency (Decimal string); null when any FX/price missing',
-      nullable: true,
-      example: '6000'
-    },
-    unrealizedPnlPct: {
-      type: 'object',
-      description: 'Unrealized P&L % (Decimal string)',
-      nullable: true,
-      example: '25'
+        'Share of the global total (0-100). 0 when globalTotal is zero (no NaN/Infinity).',
+      example: 42.5
     },
-    costFxRate: {
-      description: 'Historical FX rate applied to cost basis',
-      nullable: true,
-      allOf: [
-        {
-          $ref: '#/components/schemas/FxRateDto'
-        }
-      ]
+    groups: {
+      description: 'Per-account asset-class breakdown',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/AssetClassGroupDto'
+      }
     },
-    marketFxRate: {
-      description: 'FX rate applied to market value',
-      nullable: true,
+    uncategorized: {
+      description:
+        'Per-account grey bucket (source=FALLBACK holdings, incl. broker cash)',
       allOf: [
         {
-          $ref: '#/components/schemas/FxRateDto'
+          $ref: '#/components/schemas/AssetClassGroupDto'
         }
       ]
     },
-    pctOfInvestedAssets: {
-      type: 'object',
-      description:
-        'Share of invested assets % (Decimal string); only for invested chartTokens',
-      nullable: true,
-      example: '40'
-    },
-    realizedPnl: {
+    holdings: {
       description:
-        'Cumulative realized P&L on sold lots (asOf-date cutoff); null when the method has no applicable sells, a sell lacks a price, or any required FX rate is missing (never-mix). When a sell spans multiple currencies (cross-currency sale), amount and currency reflect the base currency; baseCcyEquivalent is always the authoritative dual-FX figure',
-      nullable: true,
-      allOf: [
-        {
-          $ref: '#/components/schemas/MonetaryDto'
-        }
-      ]
+        'Every holding row for this account (account ID in each row’s `id` field)',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/AccountItemWithAssetClassDto'
+      }
     }
   },
   required: [
     'accountId',
     'accountPath',
-    'symbol',
-    'chartToken',
-    'assetClass',
-    'units'
+    'marketValueBase',
+    'shareOfTotalPct',
+    'groups',
+    'holdings'
   ]
 } as const;
 
-export const $HoldingPnlWarningDto = {
+export const $HoldingAssetClassCrossAccountResponseDto = {
   type: 'object',
   properties: {
-    type: {
-      type: 'string',
-      description: 'Warning type',
-      example: 'MISSING_COST_FX_RATE',
-      enum: [
-        'MISSING_COST_FX_RATE',
-        'MISSING_MARKET_FX_RATE',
-        'MISSING_SALE_PRICE',
-        'MISSING_REALIZED_FX_RATE',
-        'OVERSOLD_LOTS',
-        'NO_PRICE',
-        'MIXED_COST_CURRENCY'
+    global: {
+      description: 'Merged cross-account holding aggregation',
+      allOf: [
+        {
+          $ref: '#/components/schemas/AssetClassAccountsResponseDto'
+        }
       ]
     },
-    symbol: {
-      type: 'object',
-      nullable: true
-    },
-    accountId: {
-      type: 'object',
-      nullable: true
-    },
-    currency: {
-      type: 'object',
-      nullable: true
+    byAccount: {
+      description: 'Per-account slices',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/HoldingAssetClassAccountSliceDto'
+      }
     }
   },
-  required: ['type']
+  required: ['global', 'byAccount']
 } as const;
 
-export const $HoldingPnlResponseDto = {
+export const $CashFlowByCurrencyDto = {
   type: 'object',
   properties: {
-    asOfDate: {
-      type: 'string',
-      example: '2026-07-08'
-    },
-    baseCurrency: {
-      type: 'string',
-      example: 'CNY'
-    },
-    method: {
-      type: 'string',
-      description:
-        'Realized-P&L lot-matching method (FIFO or average). Unrealized cost basis remains average regardless of this value (#473).',
-      enum: ['average', 'FIFO'],
-      example: 'average'
+    income: {
+      description: 'Income by currency',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/BalanceByCurrencyDto'
+      }
     },
-    rows: {
+    expense: {
+      description: 'Expense by currency',
       type: 'array',
       items: {
-        $ref: '#/components/schemas/HoldingPnlRowDto'
+        $ref: '#/components/schemas/BalanceByCurrencyDto'
       }
     },
-    warnings: {
+    netSavings: {
+      description: 'Net savings by currency',
       type: 'array',
       items: {
-        $ref: '#/components/schemas/HoldingPnlWarningDto'
+        $ref: '#/components/schemas/BalanceByCurrencyDto'
       }
     }
   },
-  required: ['asOfDate', 'baseCurrency', 'method', 'rows', 'warnings']
+  required: ['income', 'expense', 'netSavings']
 } as const;
 
-export const $CreateBeanPriceDto = {
+export const $ConvertedCashFlowDto = {
   type: 'object',
   properties: {
-    currency: {
+    baseCurrency: {
       type: 'string',
-      description: 'Currency being priced (e.g., USD, AAPL, BTC)',
-      example: 'USD'
+      description: 'Base currency for conversion',
+      example: 'CNY'
     },
-    quoteCurrency: {
+    income: {
       type: 'string',
-      description: 'Quote currency (pricing currency, e.g., CNY, EUR)',
-      example: 'CNY'
+      description: 'Converted income',
+      example: '25000.00'
     },
-    amount: {
-      type: 'number',
-      description:
-        'Price amount (MUST be >= 0 per Beancount spec, supports up to 15 decimal places). Zero allowed for conversion entries, negative strictly prohibited.',
-      example: 175.5,
-      minimum: 0
+    expense: {
+      type: 'string',
+      description: 'Converted expense',
+      example: '18000.00'
     },
-    date: {
+    netSavings: {
       type: 'string',
-      description: 'Price date (ISO 8601 format)',
-      example: '2024-11-05'
+      description: 'Converted net savings',
+      example: '7000.00'
     },
-    metadata: {
+    exchangeRates: {
       type: 'object',
-      description:
-        'Metadata (validated by Zod schema, max field lengths enforced)',
+      description: 'Exchange rates used for conversion',
       example: {
-        source: 'MANUAL',
-        note: 'Bank valuation report',
-        confidence: 0.95
+        USD: '7.200000'
       }
     }
   },
-  required: ['currency', 'quoteCurrency', 'amount', 'date']
+  required: ['baseCurrency', 'income', 'expense', 'netSavings', 'exchangeRates']
 } as const;
 
-export const $PriceResponseDto = {
+export const $CashFlowResponseDto = {
   type: 'object',
   properties: {
-    id: {
+    period: {
       type: 'string',
-      description: 'Unique identifier',
-      example: 'uuid-123-456'
+      description: 'Period identifier (YYYY-MM)',
+      example: '2024-06'
     },
-    userId: {
+    income: {
       type: 'string',
-      description: 'User ID (owner of the price)',
-      example: 'user-123'
+      description: 'Total income for the period (converted)',
+      example: '25000.00'
     },
-    currency: {
+    expense: {
       type: 'string',
-      description: 'Currency being priced (e.g., USD, AAPL, BTC)',
-      example: 'BTC'
+      description: 'Total expenses for the period (converted)',
+      example: '18000.00'
     },
-    quoteCurrency: {
+    netSavings: {
       type: 'string',
-      description: 'Quote currency (pricing currency, e.g., USD, CNY)',
-      example: 'USD'
+      description: 'Net savings (income - expense, converted)',
+      example: '7000.00'
     },
-    amount: {
-      type: 'number',
-      description:
-        'Price amount (corresponds to Beancount Amount.number). Supports up to 15 decimal places.',
-      example: 50000
+    savingsRate: {
+      type: 'string',
+      description: 'Savings rate percentage (netSavings / income * 100)',
+      example: '28.00'
     },
-    date: {
+    currency: {
+      type: 'string',
+      description: 'Base currency code',
+      example: 'CNY'
+    },
+    byCurrency: {
+      description: 'Cash flow grouped by original currency',
+      allOf: [
+        {
+          $ref: '#/components/schemas/CashFlowByCurrencyDto'
+        }
+      ]
+    },
+    converted: {
+      description: 'Converted values in base currency',
+      allOf: [
+        {
+          $ref: '#/components/schemas/ConvertedCashFlowDto'
+        }
+      ]
+    },
+    warnings: {
+      description: 'Exchange rate warnings',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/ExchangeRateWarningDto'
+      }
+    }
+  },
+  required: [
+    'period',
+    'income',
+    'expense',
+    'netSavings',
+    'savingsRate',
+    'currency'
+  ]
+} as const;
+
+export const $CategoryGroupDto = {
+  type: 'object',
+  properties: {
+    category: {
       type: 'string',
       description:
-        'Price date (ISO 8601 format). Represents the date this price was valid.',
-      example: '2024-01-01',
-      format: 'date'
+        'Functional category (account-path Group segment); regional and universal account paths merge under it',
+      example: 'Food'
     },
-    meta: {
-      type: 'object',
+    totalExpense: {
+      type: 'string',
       description:
-        'Metadata (corresponds to Beancount meta field). Contains source, confidence, note, etc.',
-      example: {
-        source: 'MANUAL',
-        note: 'User-defined price',
-        confidence: 1
+        'Converted total for this category in base currency (expense amount when flow=expense, income amount when flow=income)',
+      example: '1200.00'
+    },
+    sharePct: {
+      type: 'number',
+      description: 'Share of grand total (0-100); 0 when grand total is 0',
+      example: 42.5
+    },
+    balanceByCurrency: {
+      description: 'Raw (unconverted) expense per currency',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/BalanceByCurrencyDto'
       }
     },
-    createdAt: {
-      format: 'date-time',
+    convertedBalance: {
       type: 'string',
-      description: 'Creation timestamp',
-      example: '2024-11-03T10:00:00Z'
-    },
-    updatedAt: {
-      format: 'date-time',
+      description:
+        'Converted total in base currency (omitted when FX missing for all currencies in this category)',
+      example: '1200.00'
+    }
+  },
+  required: ['category', 'totalExpense', 'sharePct', 'balanceByCurrency']
+} as const;
+
+export const $ExpensesByCategorySummaryDto = {
+  type: 'object',
+  properties: {
+    totalExpense: {
       type: 'string',
-      description: 'Last update timestamp',
-      example: '2024-11-03T10:00:00Z'
+      description:
+        'Total across all categories, converted (convertible categories only); expense totals when flow=expense, income totals when flow=income',
+      example: '5000.00'
+    },
+    categoryCount: {
+      type: 'number',
+      description: 'Number of categories',
+      example: 8
     }
   },
-  required: [
-    'id',
-    'userId',
-    'currency',
-    'quoteCurrency',
-    'amount',
-    'date',
-    'meta',
-    'createdAt',
-    'updatedAt'
-  ]
+  required: ['totalExpense', 'categoryCount']
 } as const;
 
-export const $PriceListResponseDto = {
+export const $ExpensesByCategoryResponseDto = {
   type: 'object',
   properties: {
-    items: {
-      description: 'List of prices',
+    period: {
+      type: 'string',
+      description: 'Period requested',
+      example: '1m'
+    },
+    baseCurrency: {
+      type: 'string',
+      description: 'Base currency for converted values',
+      example: 'CNY'
+    },
+    groups: {
+      description:
+        'Expense groups by functional category, sorted by converted total desc',
       type: 'array',
       items: {
-        $ref: '#/components/schemas/PriceResponseDto'
+        $ref: '#/components/schemas/CategoryGroupDto'
+      }
+    },
+    summary: {
+      description: 'Summary statistics',
+      allOf: [
+        {
+          $ref: '#/components/schemas/ExpensesByCategorySummaryDto'
+        }
+      ]
+    },
+    warnings: {
+      description: 'Exchange rate warnings (e.g. missing rate for a currency)',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/ExchangeRateWarningDto'
       }
-    },
-    total: {
-      type: 'number',
-      description: 'Total number of prices',
-      example: 42
     }
   },
-  required: ['items', 'total']
+  required: ['period', 'baseCurrency', 'groups', 'summary']
 } as const;
 
-export const $UpdateBeanPriceDto = {
+export const $MonetaryDto = {
   type: 'object',
   properties: {
-    currency: {
-      type: 'string',
-      description: 'Currency being priced'
-    },
-    quoteCurrency: {
-      type: 'string',
-      description: 'Quote currency (pricing currency)'
-    },
     amount: {
-      type: 'number',
-      description: 'Price amount (MUST be >= 0 per Beancount spec)',
-      minimum: 0
+      type: 'string',
+      description: 'Amount (Decimal string)',
+      example: '3000'
     },
-    date: {
+    currency: {
       type: 'string',
-      description: 'Price date (ISO 8601 format)'
+      description: 'ISO 4217 currency',
+      example: 'USD'
     },
-    metadata: {
+    baseCcyEquivalent: {
       type: 'object',
-      description: 'Metadata'
+      description: 'Converted to user base currency (Decimal string)',
+      example: '21600',
+      nullable: true
     }
-  }
+  },
+  required: ['amount', 'currency']
 } as const;
 
-export const $CurrencyBalanceDto = {
+export const $CurrentPriceDto = {
   type: 'object',
   properties: {
+    amount: {
+      type: 'string',
+      description: 'Price amount (Decimal string)',
+      example: '250'
+    },
     currency: {
       type: 'string',
-      description: 'ISO 4217 currency code',
-      example: 'CNY'
+      description: 'Price currency (ISO 4217)',
+      example: 'USD'
     },
-    balance: {
+    date: {
       type: 'string',
-      description: 'Balance amount',
-      example: '500000.00'
+      description: 'Price date (ISO 8601)',
+      example: '2024-06-01'
+    },
+    source: {
+      type: 'string',
+      description: 'Price source',
+      example: 'USER_OVERRIDE',
+      enum: ['USER_OVERRIDE', 'OPENBB_EQUITY', 'OPENBB_CURRENCY']
     }
   },
-  required: ['currency', 'balance']
+  required: ['amount', 'currency', 'date', 'source']
 } as const;
 
-export const $TimeSeriesPointDto = {
+export const $FxRateDto = {
   type: 'object',
   properties: {
-    date: {
+    from: {
       type: 'string',
-      description: 'Date in YYYY-MM-DD format',
-      example: '2024-06-15'
+      example: 'USD'
     },
-    value: {
+    to: {
       type: 'string',
-      description: 'Value at this date (in base currency)',
-      example: '500000.00'
+      example: 'CNY'
     },
-    change: {
-      type: 'object',
-      description: 'Change from previous point',
-      example: '5000.00'
+    rate: {
+      type: 'string',
+      description: 'FX rate (Decimal string)',
+      example: '7.2'
     },
-    byCurrency: {
-      description: 'Multi-currency breakdown for this point',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/CurrencyBalanceDto'
-      }
+    date: {
+      type: 'string',
+      description: 'Rate date (ISO 8601)',
+      example: '2024-01-15'
     }
   },
-  required: ['date', 'value']
+  required: ['from', 'to', 'rate', 'date']
 } as const;
 
-export const $TrendSummaryDto = {
+export const $HoldingPnlRowDto = {
   type: 'object',
   properties: {
-    startValue: {
+    accountId: {
       type: 'string',
-      description: 'Value at start of period',
-      example: '450000.00'
+      description: 'Account UUID',
+      example: 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
     },
-    endValue: {
+    accountPath: {
       type: 'string',
-      description: 'Value at end of period',
-      example: '500000.00'
+      description: 'Full account path',
+      example: 'Assets:US:Broker:AAPL'
     },
-    totalChange: {
+    accountCcy: {
+      type: 'object',
+      description: 'Account settlement currency (ISO 4217), from cost currency',
+      nullable: true,
+      example: 'USD'
+    },
+    brokerType: {
+      type: 'object',
+      description: 'Broker type derived from Platform.type',
+      nullable: true,
+      example: 'broker'
+    },
+    symbol: {
       type: 'string',
-      description: 'Total change over period',
-      example: '50000.00'
+      description: 'Commodity symbol',
+      example: 'AAPL'
     },
-    totalChangePercentage: {
+    chartToken: {
       type: 'string',
-      description: 'Total change percentage',
-      example: '+11.11%'
+      description: 'Chart segment token (libs/common resolver)',
+      example: 'equity',
+      enum: ['equity', 'fund', 'bond', 'cash', 'other']
+    },
+    assetClass: {
+      type: 'string',
+      example: 'EQUITY'
+    },
+    assetSubClass: {
+      type: 'object',
+      nullable: true,
+      example: 'STOCK'
+    },
+    units: {
+      type: 'string',
+      description: 'Net held units (Decimal string)',
+      example: '12'
+    },
+    averageCostPerUnit: {
+      description:
+        'Average cost per unit; null when cost currency conflicts or no cost',
+      nullable: true,
+      allOf: [
+        {
+          $ref: '#/components/schemas/MonetaryDto'
+        }
+      ]
+    },
+    costBasis: {
+      description: 'Cost basis of held units',
+      nullable: true,
+      allOf: [
+        {
+          $ref: '#/components/schemas/MonetaryDto'
+        }
+      ]
+    },
+    marketValue: {
+      description: 'Market value at asOf price',
+      nullable: true,
+      allOf: [
+        {
+          $ref: '#/components/schemas/MonetaryDto'
+        }
+      ]
+    },
+    currentPrice: {
+      description: 'Price used for market value',
+      nullable: true,
+      allOf: [
+        {
+          $ref: '#/components/schemas/CurrentPriceDto'
+        }
+      ]
+    },
+    unrealizedPnlBase: {
+      type: 'object',
+      description:
+        'Unrealized P&L in base currency (Decimal string); null when any FX/price missing',
+      nullable: true,
+      example: '6000'
+    },
+    unrealizedPnlPct: {
+      type: 'object',
+      description: 'Unrealized P&L % (Decimal string)',
+      nullable: true,
+      example: '25'
+    },
+    costFxRate: {
+      description: 'Historical FX rate applied to cost basis',
+      nullable: true,
+      allOf: [
+        {
+          $ref: '#/components/schemas/FxRateDto'
+        }
+      ]
+    },
+    marketFxRate: {
+      description: 'FX rate applied to market value',
+      nullable: true,
+      allOf: [
+        {
+          $ref: '#/components/schemas/FxRateDto'
+        }
+      ]
+    },
+    pctOfInvestedAssets: {
+      type: 'object',
+      description:
+        'Share of invested assets % (Decimal string); only for invested chartTokens',
+      nullable: true,
+      example: '40'
+    },
+    realizedPnl: {
+      description:
+        'Cumulative realized P&L on sold lots (asOf-date cutoff); null when the method has no applicable sells, a sell lacks a price, or any required FX rate is missing (never-mix). When a sell spans multiple currencies (cross-currency sale), amount and currency reflect the base currency; baseCcyEquivalent is always the authoritative dual-FX figure',
+      nullable: true,
+      allOf: [
+        {
+          $ref: '#/components/schemas/MonetaryDto'
+        }
+      ]
     }
   },
-  required: ['startValue', 'endValue', 'totalChange', 'totalChangePercentage']
+  required: [
+    'accountId',
+    'accountPath',
+    'symbol',
+    'chartToken',
+    'assetClass',
+    'units'
+  ]
 } as const;
 
-export const $MultiCurrencyPointDto = {
+export const $HoldingPnlWarningDto = {
   type: 'object',
   properties: {
-    date: {
+    type: {
       type: 'string',
-      description: 'Date in YYYY-MM-DD format',
-      example: '2024-06-15'
+      description: 'Warning type',
+      example: 'MISSING_COST_FX_RATE',
+      enum: [
+        'MISSING_COST_FX_RATE',
+        'MISSING_MARKET_FX_RATE',
+        'MISSING_SALE_PRICE',
+        'MISSING_REALIZED_FX_RATE',
+        'OVERSOLD_LOTS',
+        'NO_PRICE',
+        'MIXED_COST_CURRENCY'
+      ]
     },
-    byCurrency: {
-      description: 'Balances by currency',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/CurrencyBalanceDto'
-      }
+    symbol: {
+      type: 'object',
+      nullable: true
+    },
+    accountId: {
+      type: 'object',
+      nullable: true
+    },
+    currency: {
+      type: 'object',
+      nullable: true
     }
   },
-  required: ['date', 'byCurrency']
+  required: ['type']
 } as const;
 
-export const $PortfolioTrendsResponseDto = {
+export const $HoldingPnlResponseDto = {
   type: 'object',
   properties: {
-    series: {
-      description: 'Time series data points',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/TimeSeriesPointDto'
-      }
-    },
-    summary: {
-      description: 'Period summary',
-      allOf: [
-        {
-          $ref: '#/components/schemas/TrendSummaryDto'
-        }
-      ]
-    },
-    period: {
-      type: 'string',
-      description: 'Period requested',
-      example: '6m'
-    },
-    granularity: {
+    asOfDate: {
       type: 'string',
-      description: 'Data granularity',
-      example: 'month'
+      example: '2026-07-08'
     },
-    currency: {
+    baseCurrency: {
       type: 'string',
-      description: 'Base currency for converted values',
       example: 'CNY'
     },
-    byCurrency: {
+    method: {
+      type: 'string',
       description:
-        'Multi-currency time series (each point has currency breakdown)',
+        'Realized-P&L lot-matching method (FIFO or average). Unrealized cost basis remains average regardless of this value (#473).',
+      enum: ['average', 'FIFO'],
+      example: 'average'
+    },
+    rows: {
       type: 'array',
       items: {
-        $ref: '#/components/schemas/MultiCurrencyPointDto'
+        $ref: '#/components/schemas/HoldingPnlRowDto'
       }
     },
     warnings: {
-      description: 'Exchange rate warnings',
       type: 'array',
       items: {
-        $ref: '#/components/schemas/ExchangeRateWarningDto'
+        $ref: '#/components/schemas/HoldingPnlWarningDto'
       }
     }
   },
-  required: ['series', 'summary', 'period', 'granularity', 'currency']
+  required: ['asOfDate', 'baseCurrency', 'method', 'rows', 'warnings']
 } as const;
 
-export const $CashFlowPointDto = {
+export const $AnonymousLoginDto = {
   type: 'object',
   properties: {
-    month: {
-      type: 'string',
-      description: 'Month key (YYYY-MM)',
-      example: '2024-03'
-    },
-    income: {
-      type: 'string',
-      description: 'Income in base currency (absolute, converted)',
-      example: '10000.00'
-    },
-    expense: {
-      type: 'string',
-      description: 'Expense in base currency (absolute, converted)',
-      example: '5000.00'
-    },
-    netSavings: {
+    accessToken: {
       type: 'string',
-      description: 'netSavings = income − expense (savings positive)',
-      example: '5000.00'
+      description: 'Access token for anonymous login'
     }
   },
-  required: ['month', 'income', 'expense', 'netSavings']
+  required: ['accessToken']
 } as const;
 
-export const $CashFlowTrendSummaryDto = {
+export const $AnonymousLoginResponseDto = {
   type: 'object',
   properties: {
-    totalIncome: {
-      type: 'string',
-      description: 'Total income across the period',
-      example: '60000.00'
-    },
-    totalExpense: {
-      type: 'string',
-      description: 'Total expense across the period',
-      example: '30000.00'
-    },
-    totalNetSavings: {
-      type: 'string',
-      description: 'income − expense across the period',
-      example: '30000.00'
-    },
-    averageMonthlyNetSavings: {
+    authToken: {
       type: 'string',
-      description:
-        'totalNetSavings divided by the window length (N months, incl. zero-filled)',
-      example: '5000.00'
+      description: 'JWT auth token',
+      example: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
     }
   },
-  required: [
-    'totalIncome',
-    'totalExpense',
-    'totalNetSavings',
-    'averageMonthlyNetSavings'
-  ]
+  required: ['authToken']
 } as const;
 
-export const $CashFlowTrendsResponseDto = {
+export const $SymbolSearchResultDto = {
   type: 'object',
   properties: {
-    series: {
-      description:
-        'Monthly cash-flow series (fixed N-month window, zero-filled)',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/CashFlowPointDto'
-      }
+    symbol: {
+      type: 'string',
+      example: 'AAPL'
     },
-    summary: {
-      description: 'Period totals',
-      allOf: [
-        {
-          $ref: '#/components/schemas/CashFlowTrendSummaryDto'
-        }
-      ]
+    name: {
+      type: 'object',
+      example: 'Apple Inc.',
+      nullable: true
     },
-    period: {
-      type: 'string',
-      description: 'Period requested',
-      example: '6m'
+    exchange: {
+      type: 'object',
+      example: 'US',
+      nullable: true
     },
-    granularity: {
-      type: 'string',
-      description: 'Data granularity (v1 returns month buckets)',
-      example: 'month'
+    assetType: {
+      type: 'object',
+      description: 'OpenBB asset_type (e.g. stock, etf)',
+      example: 'stock',
+      nullable: true
     },
-    currency: {
-      type: 'string',
-      description: 'Base currency for converted values',
-      example: 'CNY'
+    assetClass: {
+      type: 'object',
+      description: 'IGN asset class (region.types.ts ASSET_CLASSES)',
+      example: 'EQUITY',
+      nullable: true
     },
-    warnings: {
-      description: 'Exchange rate warnings (e.g. missing rate for a currency)',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/ExchangeRateWarningDto'
-      }
+    assetSubClass: {
+      type: 'object',
+      description: 'IGN asset sub-class (region.types.ts ASSET_SUB_CLASSES)',
+      example: 'STOCK',
+      nullable: true
+    },
+    currency: {
+      type: 'object',
+      description: 'Trading currency (extra_data or inferred from exchange)',
+      example: 'USD',
+      nullable: true
     }
   },
-  required: ['series', 'summary', 'period', 'granularity', 'currency']
-} as const;
-
-export const $GenerateSnapshotBody = {
-  type: 'object',
-  properties: {}
-} as const;
-
-export const $GenerateSnapshotResponse = {
-  type: 'object',
-  properties: {}
-} as const;
-
-export const $BackfillSnapshotsBody = {
-  type: 'object',
-  properties: {}
-} as const;
-
-export const $BackfillSnapshotsResponse = {
-  type: 'object',
-  properties: {}
+  required: ['symbol']
 } as const;
 
-export const $AnonymousLoginDto = {
+export const $SymbolQuoteDto = {
   type: 'object',
   properties: {
-    accessToken: {
+    symbol: {
       type: 'string',
-      description: 'Access token for anonymous login'
+      example: 'AAPL'
+    },
+    name: {
+      type: 'object',
+      example: 'Apple Inc.',
+      nullable: true
+    },
+    exchange: {
+      type: 'object',
+      example: 'US',
+      nullable: true
+    },
+    assetType: {
+      type: 'object',
+      description: 'OpenBB asset_type',
+      example: 'stock',
+      nullable: true
+    },
+    assetClass: {
+      type: 'object',
+      description: 'IGN asset class',
+      example: 'EQUITY',
+      nullable: true
+    },
+    assetSubClass: {
+      type: 'object',
+      description: 'IGN asset sub-class',
+      example: 'STOCK',
+      nullable: true
+    },
+    currency: {
+      type: 'object',
+      description: 'Trading currency (extra_data or inferred from exchange)',
+      example: 'USD',
+      nullable: true
+    },
+    price: {
+      type: 'object',
+      description: 'Latest price (Decimal string)',
+      example: '189.84',
+      nullable: true
+    },
+    priceDate: {
+      type: 'object',
+      description: 'Date the price was observed (ISO yyyy-MM-dd)',
+      example: '2026-08-05',
+      nullable: true
+    },
+    changePercent: {
+      type: 'object',
+      description:
+        'Change vs previous close, in percentage points (1.7 == 1.7%). openbb stores change_percent as a normalized decimal; this exposes percentage points for frontend convenience.',
+      example: 1.7,
+      nullable: true
+    },
+    prevClose: {
+      type: 'object',
+      description: 'Previous close (Decimal string)',
+      nullable: true
+    },
+    open: {
+      type: 'object',
+      description: 'Day open (Decimal string)',
+      nullable: true
+    },
+    high: {
+      type: 'object',
+      description: 'Day high (Decimal string)',
+      nullable: true
+    },
+    low: {
+      type: 'object',
+      description: 'Day low (Decimal string)',
+      nullable: true
+    },
+    volume: {
+      type: 'object',
+      description: 'Day volume (Decimal string)',
+      nullable: true
+    },
+    yearHigh: {
+      type: 'object',
+      description: '52-week high (Decimal string)',
+      nullable: true
+    },
+    yearLow: {
+      type: 'object',
+      description: '52-week low (Decimal string)',
+      nullable: true
     }
-  },
-  required: ['accessToken']
+  }
 } as const;