Atomic Vaults for Broker-Dealers

Offer U.S. and Hong Kong securities trading to your retail customers — powered by Atomic Vaults' FINRA-licensed infrastructure.

Why Atomic Vaults

As a non-US broker-dealer serving retail clients, gaining direct access to U.S. markets typically requires FINRA membership, clearing relationships, and significant compliance overhead. Atomic Vaults eliminates that:

• Skip FINRA membership — Atomic Vaults is your FINRA-licensed counterparty. You get U.S. market access without building your own broker-dealer or clearing infrastructure.
• Multi-market reach — Offer U.S. and Hong Kong securities through a single integration partner. Japan, Korea, and Taiwan coming soon.
• Full product depth — Equities, ETFs, listed options (including multi-leg strategies), overnight options, and fractional shares for U.S. markets.
• Margin and risk management — House margin calculations, ClearStreet clearing integration, and detailed margin breakdowns available via API.
• Flexible connectivity — REST API over the internet for standard integration, or FIX protocol with VPN / AWS PrivateLink / VPC peering for low-latency production environments.
• Omnibus account model — Operate under a single initiator account and manage your retail clients as end-customer (EC) sub-accounts. Handle position and cash transfers between clients programmatically.

What You Can Offer Your Clients

Capability	US Market	HK Market
Equities & ETFs	Whole + fractional shares	Board-lot based
Listed options	Single-leg + multi-leg strategies	—
Overnight options	Yes (dedicated WebSocket streams)	—
Order types	Market, limit, stop, stop-limit	Market, limit
Extended hours	24h via AV1–AV5 sessions	HK market hours (HKT)
Margin	House margin + ClearStreet clearing margin	House margin
Settlement	T+1	T+2
Asset transfers	FOP (single + CSV bulk), subaccount, internal equity	FOP, position/balance EC transfers

Onboarding Guide

Follow these steps to integrate Atomic Vaults into your brokerage platform.

Step 1: Get a staging API key

Register at the Atomic Vaults Dashboard to receive a staging API key (avs_stg_*) and test account in minutes. No sales call required for staging access.

See Self-Service Onboarding for the full walkthrough.

Step 2: Understand the account model

Atomic Vaults uses an omnibus / end-customer (EC) account structure designed for B2B2C operations:

Your Brokerage (Initiator Account)
├── EC Account: Client A
├── EC Account: Client B
└── EC Account: Client C

• Your brokerage operates under a single initiator account with its own API key and account number.
• Each of your retail clients is represented by an EC sub-account, created via POST /accounts/ec/create.
• Positions and cash can be transferred between EC accounts, or between your initiator account and EC accounts.

Step 3: Set up authentication and connectivity

All API requests require an X-API-KEY header. See the Authentication guide for usage and security best practices.

For production environments, plan your connectivity approach early:

Channel	Non-Production	Production
REST API	Open internet	IP whitelisting required
FIX	Open internet	VPN, AWS PrivateLink, or VPC peering

See the Connectivity guide for details on each option.

Step 4: Implement pre-trade checks

Before placing orders, your platform should verify:

1. Balances — GET /balances for available cash, secured amounts, and withheld amounts.
2. Margin — GET /house-margin and GET /house-margin-details for margin requirements and component breakdowns. GET /house-margin/clearstreet for clearing margin status.
3. Market status — GET /market/status to confirm the market is open and which trading session is active (AV1–AV5).
4. Reference data — GET /securities/daily-equities and GET /securities/options for tradeable instruments.

See Pre-Trade for the complete pre-trade workflow.

Step 5: Implement order flow

Place and manage orders for your clients:

Action	Endpoint
Single-leg order	POST /orders/new
Multi-leg order	POST /orders/new-multileg
Check order status	GET /orders/status
List orders	GET /orders
Modify order	POST /orders/modify
Cancel order	POST /orders/cancel

Subscribe to the WebSocket channel for real-time order events (new, fill, partial_fill, replaced, canceled).

See Trade Execution for the full order lifecycle.

Step 6: Handle post-trade operations

After trades execute, manage positions and settlements:

• Positions — GET /positions for current holdings across equities and options.
• Transactions — GET /transactions for SOD reconciliation, corporate actions, and transfer history.
• EC transfers — Move positions (POST /positions/ec-transfer) and cash (POST /balances/ec-transfer) between your clients' EC accounts.
• Subaccount transfers — POST /positions/subaccount-transfer to move between long and short subaccounts.
• FOP transfers — POST /fop-transfer for individual asset transfers, or POST /fop-transfer/upload-csv for bulk transfers via CSV.

See Post-Trade & Settlement for the complete workflow.

Step 7: Go live

When you're ready for production:

1. Complete the partner onboarding and legal agreements with Atomic Vaults.
2. Set up production connectivity — configure IP whitelisting for REST and VPN/PrivateLink for FIX if needed.
3. Receive your production API key and configure your environments.
4. Review the Orders Acceptance Matrix for session-specific order rules and the Risk Limits for execution venue risk controls.

Operational References

• US Orders Acceptance Matrix — Order types, TIF values, and execution rules by trading session (AV1–AV5)
• US Risk Limits — Execution venue risk controls and order limits
• HK Market Overview — HK-specific rules, board lots, IPO subscriptions, and T+2 settlement
• Environments & Base URLs — Production and UAT endpoints for all markets