Skip to main content

Introduction

Buildmarkets’s Market Data APIs offer access to comprehensive financial data for U.S.-listed equities, sourced from QuoteMedia. All data comes included with your Buildmarkets integration—no separate subscription needed.

Available Data Categories

The platform provides:
  • Real-time quotes via GET /v1/marketdata/real-time/{symbol} — current bid, ask, last price, and volume
  • Historical prices via GET /v1/marketdata/historical/{symbol} — end-of-day OHLCV bars with date filtering
  • Company profile via GET /v1/marketdata/company-profile/{symbol} — market cap, P/E ratio, sector, description
  • Financials via GET /v1/marketdata/balance-sheet/{symbol} — balance sheets and income statements (annual and quarterly)
  • Dividends via GET /v1/marketdata/cash-dividends/{symbol} — cash dividend records with ex-dates
  • News via GET /v1/marketdata/news/{symbol} — articles and corporate actions linked to symbols
  • Logos via GET /v1/marketdata/logos/{symbol} — company logo images
  • Reference data — security master, symbol details, sectors, and industries

Symbol Formats

Endpoints accept ticker symbols (e.g., AAPL) or identifiers with a * prefix:
  • *CUSIP format for CUSIP-based lookups
  • *ISIN format for international securities identification
The asterisk prefix indicates the API should treat input as an instrument identifier rather than a ticker symbol. This feature works on balance-sheet and cash-dividends endpoints.

Complete Endpoint List

MethodPathPurpose
GET/v1/marketdata/real-time/{symbol}Live bid/ask/last quote
GET/v1/marketdata/historical/{symbol}EOD OHLCV bars
GET/v1/marketdata/company-profile/{symbol}Company details and fundamentals
GET/v1/marketdata/balance-sheet/{symbol}Financial statements (annual or quarterly)
GET/v1/marketdata/cash-dividends/{symbol}Dividend history
GET/v1/marketdata/news/{symbol}News and corporate actions
GET/v1/marketdata/logos/{symbol}Company logo image
POST/v1/marketdata/reference/equity-security-masterPaginated list of all tradeable equities
POST/v1/marketdata/reference/symbol-detailsBulk details for a list of symbols
POST/v1/marketdata/reference/sector-symbolsAll symbols within a given sector
GET/v1/marketdata/reference/sectorsAll available sectors
GET/v1/marketdata/reference/industriesAll available industries

Authentication

All endpoints use API key authentication via the Authorization header:
Authorization: Bearer $BUILDMARKETS_API_KEY
Refer to the Authentication Overview documentation for additional details.

Rate Limiting

Market data endpoints share the same rate limit pool as other Buildmarkets API endpoints. Real-time quote endpoints support frequent polling but shouldn’t exceed one call per second per symbol in production environments. For high-frequency display scenarios, implement client-side caching with a short TTL (1–2 seconds recommended).