# Bluum Finance API Documentation

> Bluum Finance is an investment infrastructure API for fintech companies. Embed self-directed trading or full-service wealth management into your product with accounts, wallets, compliance, trading, and portfolio management.

## Get Started

- [Welcome to Bluum](https://docs.bluumfinance.com/get-started/welcome): Understand what Bluum does, how it works, and which integration path is right for your product.
- [Quick Start: Self-Directed Investing](https://docs.bluumfinance.com/get-started/quick-start-self-directed): Create an account, fund it, and place your first trade — end to end in the sandbox.
- [Quick Start: Wealth Management](https://docs.bluumfinance.com/get-started/quick-start-wealth): Set up an investor profile, run a risk assessment, create a financial plan, and launch a managed portfolio.
- [Sandbox Environment](https://docs.bluumfinance.com/get-started/sandbox): Set up and use the Bluum sandbox for development and testing.
- [Going Live](https://docs.bluumfinance.com/get-started/go-live): Production readiness checklist and deployment guide.

## Core Concepts

- [Authentication](https://docs.bluumfinance.com/platform/authentication): How to authenticate with the Bluum Finance API using HTTP Basic Auth.
- [Accounts](https://docs.bluumfinance.com/platform/accounts): Investment accounts — types, lifecycle, required fields, and relationships to other objects.
- [Compliance & KYC](https://docs.bluumfinance.com/platform/compliance-kyc): Identity verification, document requirements, and compliance workflows.
- [Wallets](https://docs.bluumfinance.com/platform/wallets): Cash balance management — wallet types, holds, and ledger entries.
- [Funding & Transfers](https://docs.bluumfinance.com/platform/funding): Deposit and withdrawal methods, transfer lifecycle, and Plaid integration.
- [Trading](https://docs.bluumfinance.com/platform/trading): Order types, lifecycle, fractional shares, and market hours.
- [Assets & Market Data](https://docs.bluumfinance.com/platform/assets): Tradable instruments, asset search, quotes, bars, and market calendar.
- [Positions](https://docs.bluumfinance.com/platform/positions): Track holdings, cost basis, market value, and unrealized P&L.

## Wealth Management

- [Wealth Management Overview](https://docs.bluumfinance.com/platform/wealth/overview): How Bluum's wealth management APIs work together — profiles, risk, planning, and portfolios.
- [Investor Profile](https://docs.bluumfinance.com/platform/wealth/investor-profile): Capture the investor's full financial picture — demographics, employment, tax, insurance, and preferences.
- [Risk Assessment](https://docs.bluumfinance.com/platform/wealth/risk-assessment): Questionnaire-based risk tolerance scoring that drives portfolio allocation.
- [Financial Planning](https://docs.bluumfinance.com/platform/wealth/financial-planning): Goals, life events, dependents, external accounts, and financial plan generation.
- [Portfolio Management](https://docs.bluumfinance.com/platform/wealth/portfolios): Managed portfolios, IPS, rebalancing, auto-invest, and DRIP.
- [Insights & Recommendations](https://docs.bluumfinance.com/platform/wealth/insights): Portfolio insights, tax optimization, AI assistant, and reporting.

## Infrastructure

- [Webhooks](https://docs.bluumfinance.com/platform/webhooks): Real-time event notifications for account, trading, and transfer activity.
- [Error Handling](https://docs.bluumfinance.com/platform/errors): Error response format, error codes, rate limiting, and retry strategies.
- [Idempotency](https://docs.bluumfinance.com/platform/idempotency): Prevent duplicate operations with idempotency keys.

## Self-Directed Investing

- [Account Onboarding](https://docs.bluumfinance.com/guides/self-directed/account-onboarding): Step-by-step guide to creating and activating investment accounts.
- [KYC Document Verification](https://docs.bluumfinance.com/guides/self-directed/kyc-verification): Upload identity documents and track verification status.
- [Link a Bank Account](https://docs.bluumfinance.com/guides/self-directed/bank-linking): Connect a bank account via Plaid Link for ACH deposits and withdrawals.
- [Deposits & Withdrawals](https://docs.bluumfinance.com/guides/self-directed/deposits-withdrawals): Fund accounts via ACH or manual bank transfer, and withdraw to linked bank accounts.
- [Placing Orders](https://docs.bluumfinance.com/guides/self-directed/placing-orders): Place market, limit, stop, and trailing stop orders with code examples.
- [Tracking Positions](https://docs.bluumfinance.com/guides/self-directed/positions-portfolio): Query positions, monitor P&L, and understand how holdings update.

## Wealth Management

- [Investor Onboarding for Wealth](https://docs.bluumfinance.com/guides/wealth/investor-onboarding): Create a wealth management account with a complete investor profile.
- [Risk Assessment & Financial Planning](https://docs.bluumfinance.com/guides/wealth/risk-and-planning): Determine risk tolerance, define goals, and generate a financial plan.
- [Setting Up Portfolios](https://docs.bluumfinance.com/guides/wealth/portfolio-setup): Create an IPS, build a managed portfolio, configure auto-invest and rebalancing.
- [Monitoring & Insights](https://docs.bluumfinance.com/guides/wealth/monitoring): Track portfolio performance, review insights, optimize taxes, and generate reports.

## Platform Operations

- [Setting Up Webhooks](https://docs.bluumfinance.com/guides/operations/webhook-setup): Register, test, and manage webhook endpoints for real-time event notifications.
- [Working with Market Data](https://docs.bluumfinance.com/guides/operations/market-data): Quotes, historical bars, snapshots, market status, and asset discovery.
- [Testing in Sandbox](https://docs.bluumfinance.com/guides/operations/testing-and-sandbox): Test scenarios, simulated behaviors, and how to validate your integration.

## Overview

- [API Reference](https://docs.bluumfinance.com/api-reference/introduction): Complete endpoint documentation with schemas, parameters, and examples.

## Changelog

- [Changelog](https://docs.bluumfinance.com/changelog/index): Latest API updates, new features, and deprecations.

## Developer Tools

- [SDKs & Libraries](https://docs.bluumfinance.com/resources/sdks): Official SDKs and client libraries for the Bluum Finance API.
- [Postman Collection](https://docs.bluumfinance.com/resources/postman): Pre-built API requests for every Bluum endpoint.
- [AI-Assisted Development](https://docs.bluumfinance.com/resources/ai-tools): Use AI coding assistants effectively with Bluum's documentation and API specifications.

## Reference

- [Error Code Reference](https://docs.bluumfinance.com/resources/error-codes): Complete catalog of Bluum API error codes with troubleshooting guidance.
- [Glossary](https://docs.bluumfinance.com/resources/glossary): Key terms and concepts used throughout the Bluum Finance API.

## Support

- [Getting Help](https://docs.bluumfinance.com/resources/support): Support channels, escalation paths, and how to report issues.

## Optional

- [System Status](https://status.bluumfinance.com): Check for ongoing incidents
- [Dashboard](https://dashboard.bluumfinance.com): Manage API credentials and accounts