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). Two snapshot-specific failures also surface as 400: StartSessionStockPricesUnavailable when no prices exist for the current / requested session, and EndSessionStockPricesUnavailable when no prices exist for the previous-session window. Both carry session-specific messages in the response.

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