/v1/*. Bluum orchestrates the downstream work and returns clean, normalized responses. Webhooks notify you when asynchronous work finishes (order fills, deposit arrivals, KYC decisions).
The path from here
This guide is a straight line. Read it top to bottom and you’ll go from zero to a funded investor placing live trades in the sandbox — without jumping between sections.How the API works
Auth, environments, rate limits, idempotency, pagination, errors.
Create a sandbox account
Get API credentials in a few minutes.
Build your integration
The end-to-end flow: investor → fund → trade → withdraw.
Core objects
The building blocks you’ll work with:| Object | What it represents |
|---|---|
| Investor | One end user’s investing account. Holds identity, contact, disclosures, and agreements. ID prefix inv_. |
| Wallet | The cash balance for an investor. Receives deposits, funds trades, disburses withdrawals. |
| Funding source | A linked bank account (via Plaid) used for ACH deposits and withdrawals. ID prefix fs_. |
| Deposit / Withdrawal | A money movement into or out of a wallet. ID prefixes dep_ / wd_. |
| Order | A buy or sell instruction — market, limit, stop, or trailing stop. ID prefix ord_. |
| Position | A holding in one asset — quantity, cost basis, market value, and P&L. ID prefix pos_. |
| Document | An uploaded file (KYC and more), owned by a tenant, investor, or user. ID prefix doc_. |
| Webhook | A registered URL that receives event notifications. ID prefix wh_. |
Two ways to embed investing
Self-directed investing
Your users decide what to buy and sell.
management_type: "self_directed". This guide covers it end to end.Best for: trading apps, invest tabs, stock gifting, round-ups.Wealth management
Bluum’s engine manages portfolios on behalf of your users — planning, risk, auto-invest. An add-on product enabled per tenant.Best for: robo-advisors, planner apps, employee benefits. Book a demo.
Environments
| Environment | Base URL | Purpose |
|---|---|---|
| Sandbox | https://sandbox.api.bluumfinance.com/v1 | Development and testing. Simulated fills. No approval needed. |
| Production | https://api.bluumfinance.com/v1 | Live money and securities. Requires compliance approval. |