Market prices and company fundamentals

Delayed quotes and history, financial statements, valuation statistics and company profiles.

One row is

Delayed quotes and history, financial statements, valuation statistics and company profiles

Example response

Trimmed real output. No key needed.

GET /v1/datasets/market-data/sample

Dates reflect the example, not current coverage.

{
  "data": {
    "symbol": "COST",
    "period": "annual",
    "rows": [
      {
        "date": "2022-08-28",
        "dateSource": "sec",
        "currency": "USD",
        "totalRevenue": 226954000000,
        "fieldAvailability": {
          "totalRevenue": "2022-10-05",
          "netIncome": "2022-10-05",
          "operatingCashFlow": "2022-10-05",
          "totalAssets": "2022-10-05",
          "cashFlowFromContinuingOperatingActivities": "2022-10-05"
        },
        "availableAt": "2022-10-05",
        "netIncome": 5844000000,
        "fieldSources": {
          "netIncome": {
            "source": "sec",
            "concept": "NetIncomeLoss",
            "basis": "parent",
            "accessionNumber": "0000909832-22-000021",
            "filed": "2022-10-05",
            "startDate": "2021-08-30",
            "endDate": "2022-08-28",
            "unit": "USD"
          }
        },
        "operatingCashFlow": 7392000000,
        "totalAssets": 64166000000,
        "cashFlowFromContinuingOperatingActivities": 7392000000,
        "unavailableFields": [
          "netIncomeIncludingNoncontrollingInterests",
          "netIncomeCommonStockholders"
        ],
        "dateEvidence": {
          "accessionNumber": "0000909832-22-000021",
          "filed": "2022-10-05",
          "startDate": "2021-08-30"
        }
      },
      {
        "date": "2023-09-03",
        "dateSource": "sec",
        "currency": "USD",
        "totalRevenue": 242290000000,
        "fieldAvailability": {
          "totalRevenue": "2023-10-11",
          "netIncome": "2023-10-11",
          "operatingCashFlow": "2023-10-11",
          "totalAssets": "2023-10-11",
          "cashFlowFromContinuingOperatingActivities": "2023-10-11"
        },
        "availableAt": "2023-10-11",
        "netIncome": 6292000000,
        "fieldSources": {
          "netIncome": {
            "source": "sec",
            "concept": "NetIncomeLoss",
            "basis": "parent",
            "accessionNumber": "0000909832-23-000042",
            "filed": "2023-10-11",
            "startDate": "2022-08-29",
            "endDate": "2023-09-03",
            "unit": "USD"
          }
        },
        "operatingCashFlow": 11068000000,
        "totalAssets": 68994000000,
        "cashFlowFromContinuingOperatingActivities": 11068000000,
        "unavailableFields": [
          "netIncomeIncludingNoncontrollingInterests",
          "netIncomeCommonStockholders"
        ],
        "dateEvidence": {
          "accessionNumber": "0000909832-23-000042",
          "filed": "2023-10-11",
          "startDate": "2022-08-29"
        }
      },
      {
        "date": "2024-09-01",
        "dateSource": "sec",
        "currency": "USD",
        "totalRevenue": 254453000000,
        "fieldAvailability": {
          "totalRevenue": "2024-10-09",
          "netIncome": "2024-10-09",
          "operatingCashFlow": "2024-10-09",
          "totalAssets": "2024-10-09",
          "cashFlowFromContinuingOperatingActivities": "2024-10-09"
        },
        "availableAt": "2024-10-09",
        "netIncome": 7367000000,
        "fieldSources": {
          "netIncome": {
            "source": "sec",
            "concept": "NetIncomeLoss",
            "basis": "parent",
            "accessionNumber": "0000909832-24-000049",
            "filed": "2024-10-09",
            "startDate": "2023-09-04",
            "endDate": "2024-09-01",
            "unit": "USD"
          }
        },
        "operatingCashFlow": 11339000000,
        "totalAssets": 69831000000,
        "cashFlowFromContinuingOperatingActivities": 11339000000,
        "unavailableFields": [
          "netIncomeIncludingNoncontrollingInterests",
          "netIncomeCommonStockholders"
        ],
        "dateEvidence": {
          "accessionNumber": "0000909832-24-000049",
          "filed": "2024-10-09",
          "startDate": "2023-09-04"
        }
      },
      {
        "date": "2025-08-31",
        "dateSource": "sec",
        "currency": "USD",
        "totalRevenue": 275235000000,
        "fieldAvailability": {
          "totalRevenue": "2025-10-08",
          "netIncome": "2025-10-08",
          "operatingCashFlow": "2025-10-08",
          "totalAssets": "2025-10-08",
          "cashFlowFromContinuingOperatingActivities": "2025-10-08"
        },
        "availableAt": "2025-10-08",
        "netIncome": 8099000000,
        "fieldSources": {
          "netIncome": {
            "source": "sec",
            "concept": "NetIncomeLoss",
            "basis": "parent",
            "accessionNumber": "0000909832-25-000101",
            "filed": "2025-10-08",
            "startDate": "2024-09-02",
            "endDate": "2025-08-31",
            "unit": "USD"
          }
        },
        "operatingCashFlow": 13335000000,
        "totalAssets": 77099000000,
        "cashFlowFromContinuingOperatingActivities": 13335000000,
        "unavailableFields": [
          "netIncomeIncludingNoncontrollingInterests",
          "netIncomeCommonStockholders"
        ],
        "dateEvidence": {
          "accessionNumber": "0000909832-25-000101",
          "filed": "2025-10-08",
          "startDate": "2024-09-02"
        }
      }
    ]
  },
  "meta": {
    "dataset": "market-data",
    "asOf": "2025-08-31",
    "source": [
      {
        "id": "sec-edgar",
        "attribution": "U.S. Securities and Exchange Commission and the filing issuer",
        "licence": "Public SEC filings; preserve filing attribution and fair-access limits"
      },
      {
        "id": "market-data",
        "attribution": "Exchange and market data providers",
        "licence": "Use subject to Gloom Datasets terms"
      },
      {
        "id": "exchange-feeds",
        "attribution": "Exchange and market data providers",
        "licence": "Use subject to Gloom Datasets terms"
      }
    ],
    "historyStarts": "2022-08-28",
    "coverage": {
      "statements": 4
    },
    "lastUpdated": "2025-10-08"
  }
}

Routes

Base URL https://api.gloom.sh. Send a key with each call; the key's account needs a plan.

GET /v1/fundamentals/{symbol}/statements20 credits

Annual or quarterly income, balance sheet and cash flow statements. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameter: symbol
In: path, required
Type: string ^[A-Za-z0-9.:-]{1,32}$
Notes: Company symbol; normalized to uppercase.

Parameter: exchange
In: query
Type: string

Parameter: period
In: query
Type: annual, quarterly
Notes: Statement period, annual by default.

Parameter	In	Type	Notes
`symbol`	path, required	string `^[A-Za-z0-9.:-]{1,32}$`	Company symbol; normalized to uppercase.
`exchange`	query	string
`period`	query	`annual`, `quarterly`	Statement period, annual by default.

Credits: 20 (evidence x4)
Plans: Basic, Desk, Enterprise

GET /v1/fundamentals/{symbol}/statistics20 credits

Company valuation ratios and key financial statistics. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameter: symbol
In: path, required
Type: string ^[A-Za-z0-9.:-]{1,32}$
Notes: Company symbol; normalized to uppercase.

Parameter: exchange
In: query
Type: string

Parameter	In	Type	Notes
`symbol`	path, required	string `^[A-Za-z0-9.:-]{1,32}$`	Company symbol; normalized to uppercase.
`exchange`	query	string

Credits: 20 (evidence x4)
Plans: Basic, Desk, Enterprise

GET /v1/fundamentals/{symbol}/profile10 credits

Company business description and profile. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameter: symbol
In: path, required
Type: string ^[A-Za-z0-9.:-]{1,32}$
Notes: Company symbol; normalized to uppercase.

Parameter: exchange
In: query
Type: string

Parameter	In	Type	Notes
`symbol`	path, required	string `^[A-Za-z0-9.:-]{1,32}$`	Company symbol; normalized to uppercase.
`exchange`	query	string

Credits: 10 (evidence x2)
Plans: Basic, Desk, Enterprise

GET /v1/market/quotes4 credits

Delayed market quotes for up to ten tickers. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameter: tickers
In: query, required
Type: string
Notes: Comma-separated tickers, at most ten.

Parameter	In	Type	Notes
`tickers`	query, required	string	Comma-separated tickers, at most ten.

Credits: 4 (search x2)
Plans: Basic, Desk, Enterprise

GET /v1/market/data20 credits

Field-level data for one ticker. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameter: tickers
In: query, required
Type: string
Notes: One ticker per call.

Parameter: fields
In: query, required
Type: string
Notes: Comma-separated field names, at most 25.

Parameter: period
In: query
Type: annual, quarterly

Parameter	In	Type	Notes
`tickers`	query, required	string	One ticker per call.
`fields`	query, required	string	Comma-separated field names, at most 25.
`period`	query	`annual`, `quarterly`

Credits: 20 (evidence x4)
Plans: Basic, Desk, Enterprise

GET /v1/market/history4 credits

Delayed price history for one ticker and up to 366 days. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameter: tickers
In: query, required
Type: string
Notes: One ticker per call.

Parameter: fields
In: query
Type: string
Notes: Price fields; price and volume by default.

Parameter: start
In: query
Type: date, YYYY-MM-DD
Notes: Valid calendar date (YYYY-MM-DD). from must be on or before to.

Parameter: end
In: query
Type: date, YYYY-MM-DD
Notes: Valid calendar date (YYYY-MM-DD). from must be on or before to.

Parameter: period
In: query
Type: daily, weekly, monthly

Parameter	In	Type	Notes
`tickers`	query, required	string	One ticker per call.
`fields`	query	string	Price fields; price and volume by default.
`start`	query	date, `YYYY-MM-DD`	Valid calendar date (YYYY-MM-DD). from must be on or before to.
`end`	query	date, `YYYY-MM-DD`	Valid calendar date (YYYY-MM-DD). from must be on or before to.
`period`	query	`daily`, `weekly`, `monthly`

Credits: 4 (history x2)
Plans: Basic, Desk, Enterprise

GET /v1/market/fields2 credits

Field dictionary with units and supported history periods. Reads the existing dataset service and needs a key on an account with a plan; every plan reads every live dataset in full. Cached market reads can refresh their source data. Unknown, empty and repeated parameters are rejected. History and coverage metadata are null when the stored service cannot establish them.

Parameters: none.

Credits: 2 (lookup x2)
Plans: Basic, Desk, Enterprise

Meta fields

Field: dataset
Here: The dataset id
In the example: "market-data"

Field: asOf
Here: The observation date established by the service; otherwise null
In the example: "2025-08-31"

Field: source
Here: Attribution and usage terms of each source
In the example: 3 sources

Field: historyStarts
Here: Earliest stored history when established by the service; otherwise null.
In the example: "2022-08-28"

Field: coverage
Here: Service-established coverage; null when unavailable.
In the example: {"statements":4}

Field: lastUpdated
Here: The source update time established by the service; otherwise null
In the example: "2025-10-08"

Field	Here	In the example
`dataset`	The dataset id	`"market-data"`
`asOf`	The observation date established by the service; otherwise null	`"2025-08-31"`
`source`	Attribution and usage terms of each source	3 sources
`historyStarts`	Earliest stored history when established by the service; otherwise null.	`"2022-08-28"`
`coverage`	Service-established coverage; null when unavailable.	`{"statements":4}`
`lastUpdated`	The source update time established by the service; otherwise null	`"2025-10-08"`

Sources

Source: U.S. Securities and Exchange Commission and the filing issuer
Usage terms: Public SEC filings; preserve filing attribution and fair-access limits

Source: Exchange and market data providers
Usage terms: Use subject to Gloom Datasets terms

Source: Exchange and market data providers
Usage terms: Use subject to Gloom Datasets terms

Source	Usage terms
U.S. Securities and Exchange Commission and the filing issuer	Public SEC filings; preserve filing attribution and fair-access limits
Exchange and market data providers	Use subject to Gloom Datasets terms
Exchange and market data providers	Use subject to Gloom Datasets terms

Errors

These routes can answer 400, 401, 402, 403, 404, 429, 503. See Errors for the codes.

Gloom Datasets reads stored data only: a call never starts a collection.