Skip to main content
Assets are the tradable instruments available through Bluum — stocks, ETFs, and other securities. Market Data provides real-time and historical pricing, market status, and trading calendars.

Asset classes

ClassDescriptionMarkets
us_equityUS-listed stocks and ETFsXNAS (NASDAQ), XNYS (NYSE)

Searching assets

Find assets by symbol, name, or filters:
# Search by symbol or name
curl -X GET "$BASE_URL/assets/search?q=apple" \
  -H "Authorization: Basic $AUTH"

# List tradable US equities
curl -X GET "$BASE_URL/assets/list?asset_class=us_equity&tradable=true" \
  -H "Authorization: Basic $AUTH"

# Get a specific asset
curl -X GET "$BASE_URL/assets/AAPL" \
  -H "Authorization: Basic $AUTH"

Asset object

{
  "id": "6c5b2403-24a9-4b55-a3dd-5cb1e4b50da6",
  "symbol": "AAPL",
  "name": "Apple Inc.",
  "class": "us_equity",
  "exchange": "NASDAQ",
  "status": "active",
  "tradable": true,
  "fractionable": true
}
Key fields:
  • tradable — Whether the asset can be traded through Bluum
  • fractionable — Whether fractional shares are supported (enables notional orders)

Market data

Quotes

Get the latest quote for an asset:
curl -X GET "$BASE_URL/market-data/assets/AAPL/quote" \
  -H "Authorization: Basic $AUTH"

Historical bars (OHLCV)

Get historical price data:
curl -X GET "$BASE_URL/market-data/assets/AAPL/bars?timeframe=1Day&start=2025-01-01&end=2025-06-15" \
  -H "Authorization: Basic $AUTH"

Snapshots

Get a complete market snapshot for an asset (quote + latest bar + previous close):
curl -X GET "$BASE_URL/market-data/assets/AAPL/snapshot" \
  -H "Authorization: Basic $AUTH"

Charts

Get chart-ready data for an asset:
curl -X GET "$BASE_URL/assets/chart?symbol=AAPL&timeframe=1Day&period=1M" \
  -H "Authorization: Basic $AUTH"

Market status and calendar

Check if a market is currently open and get the trading calendar:
# List all markets
curl -X GET "$BASE_URL/market-data/markets" \
  -H "Authorization: Basic $AUTH"

# Check if NYSE is open
curl -X GET "$BASE_URL/market-data/markets/XNYS/status" \
  -H "Authorization: Basic $AUTH"

# Get trading calendar (open/close times, holidays)
curl -X GET "$BASE_URL/market-data/markets/XNYS/calendar?start=2025-06-01&end=2025-06-30" \
  -H "Authorization: Basic $AUTH"

Key endpoints

MethodPathDescription
GET/assets/searchSearch assets by name or symbol
GET/assets/listList assets with filters
GET/assets/{symbol}Get asset details
GET/assets/chartGet chart data
GET/market-data/assets/{symbol}/quoteLatest quote
GET/market-data/assets/{symbol}/barsHistorical OHLCV bars
GET/market-data/assets/{symbol}/snapshotMarket snapshot
GET/market-data/marketsList markets
GET/market-data/markets/{code}/statusMarket open/closed status
GET/market-data/markets/{code}/calendarTrading calendar