Skip to main content

Getting Started

Overview​

The Atomic Vaults API lets you integrate U.S. equities, ETFs, and listed options trading into your platform. Atomic Vaults acts as your FINRA-licensed counterparty, handling clearing, settlement, and regulatory compliance on your behalf.

Multiple markets and environments are available. See Environments & Base URLs for the full list.

Base URL Placeholder

Code examples on this page use {BASE_URL} as a placeholder. Replace it with the actual endpoint for your market and environment (e.g. https://staging.atomicvaults.com for US Staging). See Environments & Base URLs for all available endpoints.

Authentication​

All API requests require an X-API-KEY header. See the Authentication guide for details.

curl -H "X-API-KEY: your-api-key" \
  {BASE_URL}/balances

Quick Example​

Check Account Balance​

curl -H "X-API-KEY: your-api-key" \
  {BASE_URL}/balances

Response:

{
  "cash_available": "10000.00",
  "cash_secured": "0.00",
  "cash_withheld_for_buys": "0.00",
  "cash_withheld_for_exercise": "0.00"
}

Place an Order​

curl -X POST \
  -H "X-API-KEY: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "AAPL",
    "side": "buy",
    "qty": "10",
    "type": "market",
    "time_in_force": "day"
  }' \
  {BASE_URL}/orders/new

Next Steps​