Market Map

Overview

Market Map returns a market-wide snapshot of every supported ticker with its current and previous session prices, company name, sector, industry, and market capitalization. Suited for treemap-style visualizations of the whole equity universe in one request.

POST/v1/equities/tool/market-map
curl -X POST https://api.quantdata.us/v1/equities/tool/market-map \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{}'

Selecting the snapshot

Market Map supports sessionDate for the latest snapshot of a given session, or snapshotTime for a specific instant. The two are mutually exclusive; if both are omitted, the latest snapshot of the current session is returned. timeRange and aggregationPeriod are not accepted on this endpoint.

Snapshot at a specific instant

Request · snapshotTime
{
  "snapshotTime": "2026-05-13T16:30:00Z"
}

Response shape

data walks ticker -> company snapshot. Keys are ticker symbols sorted ascending.

200 OK · application/json
{
  "data": {
    "AAPL": {
      "companyName": "Apple Inc.",
      "currentValue": 218.42,
      "industry": "Consumer Electronics",
      "previousValue": 216.18,
      "sector": "Technology",
      "size": 3320000000000.0
    },
    "NVDA": {
      "companyName": "NVIDIA Corporation",
      "currentValue": 920.15,
      "industry": "Semiconductors",
      "previousValue": 908.42,
      "sector": "Technology",
      "size": 2260000000000.0
    },
    "TSLA": {
      "companyName": "Tesla, Inc.",
      "currentValue": 182.51,
      "industry": "Auto Manufacturers",
      "previousValue": 178.40,
      "sector": "Consumer Cyclical",
      "size": 580000000000.0
    }
  }
}

Per-ticker fields:

  • companyName (string): the FMP-sourced company name.
  • currentValue (double, dollars): the stock price at the selected snapshot or session.
  • previousValue (double, dollars): the stock price at the previous-session window.
  • sector (string): the FMP-sourced sector label.
  • industry (string): the FMP-sourced industry label.
  • size (double, dollars): the market capitalization. Typed as double to carry the full FMP magnitude.

Where errors come from

Malformed input surfaces as ValidationFailure (400). The two snapshot-specific no-data outcomes surface as 422 · data-unavailable: StartSessionStockPricesUnavailable when no prices exist for the previous trading session, and EndSessionStockPricesUnavailable when no prices exist for the requested session. Each detail states which session (previous or requested) was missing prices.

Filters

Convenience filter fields cover the company-profile dimensions. All are optional and inside filter.

  • sectors: one or more sector values, OR-combined. The full list is below.
  • industries: one or more industry values, OR-combined. The full list is below.

The filterExpression DSL is also accepted and can be combined with filter; both are evaluated as AND. filterExpression works over COMPANY_NAME, EXCHANGE, INDUSTRY, MARKET_CAP (alias MARKET_CAPITALIZATION), SECTOR, and SYMBOL (alias TICKER).

Convenience filter · sector and industry

Request · sectors + industries
{
  "sessionDate": "2026-05-13",
  "filter": {
    "sectors": ["TECHNOLOGY"],
    "industries": ["SEMICONDUCTORS"]
  }
}

Filter expression · large-cap technology only

Request · filterExpression
{
  "sessionDate": "2026-05-13",
  "filterExpression": {
    "operator": "AND",
    "operands": [
      { "field": "SECTOR", "comparator": "EQUALS", "value": "TECHNOLOGY" },
      { "field": "MARKET_CAP", "comparator": "GREATER_THAN", "value": 100000000000 }
    ]
  }
}

Sector List

Sector List12 values

The values sectors accepts. Filter input is case-, separator-, and whitespace-insensitive, so FINANCIAL_SERVICES, financialServices, and "financial services" all resolve to the same constant.

  • BASIC_MATERIALS
  • COMMUNICATION_SERVICES
  • CONSUMER_CYCLICAL
  • CONSUMER_DEFENSIVE
  • ENERGY
  • FINANCIAL_SERVICES
  • HEALTHCARE
  • INDUSTRIALS
  • NOT_APPLICABLE
  • REAL_ESTATE
  • TECHNOLOGY
  • UTILITIES

Industry List

Industry List160 values

The values industries accepts. A few constants appear with a double underscore in responses (e.g. ASSET_MANAGEMENT__BONDS) to mark a sub-category, but on input any case + separator combination is accepted: "asset management bonds", assetManagementBonds, and ASSET_MANAGEMENT_BONDS (single underscore) all resolve to the same constant.

  • ADVERTISING_AGENCIES
  • AEROSPACE_AND_DEFENSE
  • AGRICULTURAL_FARM_PRODUCTS
  • AGRICULTURAL_INPUTS
  • AGRICULTURAL__COMMODITIES_MILLING
  • AGRICULTURAL__MACHINERY
  • AIRLINES_AIRPORTS_AND_AIR_SERVICES
  • ALUMINUM
  • APPAREL__FOOTWEAR_AND_ACCESSORIES
  • APPAREL__MANUFACTURERS
  • APPAREL__RETAIL
  • ASSET_MANAGEMENT
  • ASSET_MANAGEMENT__BONDS
  • ASSET_MANAGEMENT__CRYPTOCURRENCY
  • ASSET_MANAGEMENT__GLOBAL
  • ASSET_MANAGEMENT__INCOME
  • ASSET_MANAGEMENT__LEVERAGED
  • AUTO__DEALERSHIPS
  • AUTO__MANUFACTURERS
  • AUTO__PARTS
  • AUTO__RECREATIONAL_VEHICLES
  • BANKS
  • BANKS__DIVERSIFIED
  • BANKS__REGIONAL
  • BEVERAGES__ALCOHOLIC
  • BEVERAGES__NON_ALCOHOLIC
  • BEVERAGES__WINERIES_AND_DISTILLERIES
  • BIOTECHNOLOGY
  • BROADCASTING
  • BUSINESS_EQUIPMENT_AND_SUPPLIES
  • CHEMICALS
  • CHEMICALS__SPECIALTY
  • COAL
  • COMMUNICATION_EQUIPMENT
  • COMPUTER_HARDWARE
  • CONGLOMERATES
  • CONSTRUCTION
  • CONSTRUCTION_MATERIALS
  • CONSULTING_SERVICES
  • CONSUMER_ELECTRONICS
  • COPPER
  • DEPARTMENT_STORES
  • DISCOUNT_STORES
  • DIVERSIFIED_UTILITIES
  • DRUG_MANUFACTURERS__GENERAL
  • DRUG_MANUFACTURERS__SPECIALTY_AND_GENERIC
  • EDUCATION_AND_TRAINING_SERVICES
  • ELECTRICAL_EQUIPMENT_AND_PARTS
  • ELECTRONIC_GAMING_AND_MULTIMEDIA
  • ENGINEERING_AND_CONSTRUCTION
  • ENTERTAINMENT
  • ENVIRONMENTAL_SERVICES
  • FINANCIAL__CAPITAL_MARKETS
  • FINANCIAL__CONGLOMERATES
  • FINANCIAL__CREDIT_SERVICES
  • FINANCIAL__DATA_AND_STOCK_EXCHANGES
  • FINANCIAL__DIVERSIFIED
  • FINANCIAL__MORTGAGES
  • FOOD_CONFECTIONERS
  • FOOD_DISTRIBUTION
  • FURNISHINGS_FIXTURES_AND_APPLIANCES
  • GAMBLING_RESORTS_AND_CASINOS
  • GENERAL_TRANSPORTATION
  • GENERAL_UTILITIES
  • GOLD
  • GROCERY_STORES
  • HARDWARE_EQUIPMENT_AND_PARTS
  • HOME_IMPROVEMENT
  • HOUSEHOLD_AND_PERSONAL_PRODUCTS
  • INDEPENDENT_POWER_PRODUCERS
  • INDUSTRIAL_MATERIALS
  • INDUSTRIAL__CAPITAL_GOODS
  • INDUSTRIAL__DISTRIBUTION
  • INDUSTRIAL__INFRASTRUCTURE_OPERATIONS
  • INDUSTRIAL__MACHINERY
  • INDUSTRIAL__POLLUTION_AND_TREATMENT_CONTROLS
  • INDUSTRIAL__SPECIALTIES
  • INFORMATION_TECHNOLOGY_SERVICES
  • INSURANCE__BROKERS
  • INSURANCE__DIVERSIFIED
  • INSURANCE__LIFE
  • INSURANCE__PROPERTY_AND_CASUALTY
  • INSURANCE__REINSURANCE
  • INSURANCE__SPECIALTY
  • INTEGRATED_FREIGHT_AND_LOGISTICS
  • INTERNET_CONTENT_AND_INFORMATION
  • INVESTMENT__BANKING_AND_INVESTMENT_SERVICES
  • LEISURE
  • LUXURY_GOODS
  • MANUFACTURING__METAL_FABRICATION
  • MANUFACTURING__MISCELLANEOUS
  • MANUFACTURING__TEXTILES
  • MANUFACTURING__TOOLS_AND_ACCESSORIES
  • MARINE_SHIPPING
  • MEDIA_AND_ENTERTAINMENT
  • MEDICAL__CARE_FACILITIES
  • MEDICAL__DEVICES
  • MEDICAL__DIAGNOSTICS_AND_RESEARCH
  • MEDICAL__DISTRIBUTION
  • MEDICAL__EQUIPMENT_AND_SERVICES
  • MEDICAL__HEALTHCARE_INFORMATION_SERVICES
  • MEDICAL__HEALTHCARE_PLANS
  • MEDICAL__INSTRUMENTS_AND_SUPPLIES
  • MEDICAL__PHARMACEUTICALS
  • MEDICAL__SPECIALTIES
  • NOT_APPLICABLE
  • OIL_AND_GAS_DRILLING
  • OIL_AND_GAS_ENERGY
  • OIL_AND_GAS_EQUIPMENT_AND_SERVICES
  • OIL_AND_GAS_EXPLORATION_AND_PRODUCTION
  • OIL_AND_GAS_INTEGRATED
  • OIL_AND_GAS_MIDSTREAM
  • OIL_AND_GAS_REFINING_AND_MARKETING
  • OTHER_PRECIOUS_METALS
  • PACKAGED_FOODS
  • PACKAGING_AND_CONTAINERS
  • PAPER_LUMBER_AND_FOREST_PRODUCTS
  • PERSONAL_PRODUCTS_AND_SERVICES
  • PUBLISHING
  • RAILROADS
  • REAL_ESTATE__DEVELOPMENT
  • REAL_ESTATE__DIVERSIFIED
  • REAL_ESTATE__GENERAL
  • REAL_ESTATE__SERVICES
  • REGULATED_ELECTRIC
  • REGULATED_GAS
  • REGULATED_WATER
  • REIT__DIVERSIFIED
  • REIT__HEALTHCARE_FACILITIES
  • REIT__HOTEL_AND_MOTEL
  • REIT__INDUSTRIAL
  • REIT__MORTGAGE
  • REIT__OFFICE
  • REIT__RESIDENTIAL
  • REIT__RETAIL
  • REIT__SPECIALTY
  • RENEWABLE_UTILITIES
  • RENTAL_AND_LEASING_SERVICES
  • RESIDENTIAL_CONSTRUCTION
  • RESTAURANTS
  • SECURITY_AND_PROTECTION_SERVICES
  • SEMICONDUCTORS
  • SHELL_COMPANIES
  • SILVER
  • SOFTWARE__APPLICATION
  • SOFTWARE__INFRASTRUCTURE
  • SOFTWARE__SERVICES
  • SOLAR
  • SPECIALTY_BUSINESS_SERVICES
  • SPECIALTY_RETAIL
  • STAFFING_AND_EMPLOYMENT_SERVICES
  • STEEL
  • TECHNOLOGY_DISTRIBUTORS
  • TELECOMMUNICATIONS_SERVICES
  • TOBACCO
  • TRAVEL_LODGING
  • TRAVEL_SERVICES
  • TRUCKING
  • URANIUM
  • WASTE_MANAGEMENT

See Field Reference for the type and allowed values of every filterable field, and Filter Expression for the full DSL grammar.

Where to go next