Executive pay, government awards, KPIs and 8-K events.Every value cited.

7 datasets from SEC filings and public agencies, behind one key. Each response names its sources.

See plansRead the docs

Plans start at $200 a month. The responses below are synthetic examples and need no account.

Request · Executive pay2 credits
curl https://api.gloom.sh/v1/exec-pay/AAPL \
  -H "Authorization: Bearer $GLOOM_DATASETS_KEY"
Example response · meta
{
  "dataset": "exec-pay",
  "asOf": null,
  "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"
    }
  ],
  "historyStarts": null,
  "coverage": null,
  "lastUpdated": null,
  "sample": true,
  "note": "ILLUSTRATIVE: synthetic examples showing the response fields; not real company disclosures or published observations."
}

The full example, no key or account: https://api.gloom.sh/v1/datasets/exec-pay/sample

Example response · data.proxies[0]synthetic values
{
  "id": "illustrative-proxy-0",
  "ticker": "ILLUSTRATIVE",
  "company": {
    "ticker": "ILLUSTRATIVE",
    "cik": null,
    "name": "Illustrative Company",
    "shortName": "Illustrative Company"
  },
  "proxyYear": 2026,
  "fiscalYear": 2025,
  "fiscalYearLabel": "2025",
  "filedAt": "2026-03-30T12:00:00.000Z",
  "meetingDate": null,
  "updatedAt": "2026-09-30T12:00:00.000Z",
  "ceoName": "Illustrative Executive",
  "ceoTitle": "Chief Executive Officer",
  "ceoTotal": 1000000,
  "ceoPriorYearTotal": null,
  "payRatio": null,
  "medianEmployeePay": null
}

7 live, 8 coming.

  • Executive payLive
    /v1/exec-pay/{symbol} 2/v1/exec-pay/{symbol}/{year} 10

    One proxy year: CEO pay, named executives, pay ratio

    History: not stated yet · Class x2

  • Government awardsLive
    /v1/awards 4/v1/awards/{id} 10

    One award: agency, recipient, amount, date, source record

    History: not stated yet · Class x2

  • KPIs and guidanceLive
    /v1/kpis/{symbol} 2/4/v1/guidance/{symbol} 2/4

    One reported metric or guide for a period, with the filing quote

    History: not stated yet · Class x2

  • 8-K eventsLive
    /v1/events/{symbol} 2

    One 8-K filing: item codes, labels, filing link

    History: not stated yet · Class x1

  • US consumer pricesLive
    /v1/macro/cpi 1

    One CPI component: weight, monthly and yearly change

    History: not stated yet · Class x1

  • EIA energy inventoriesLive
    /v1/energy/inventories 1

    One weekly EIA series: level and weekly change

    History: not stated yet · Class x1

  • CFTC positioningLive
    /v1/cftc/cot 1/v1/cftc/cot/contracts/{contractCode} 2

    One futures contract: open interest, positions by trader class

    History: not stated yet · Class x1

  • Risk factorsComing

    One 10-K risk section and its changes from the year before

    History: not stated yet

  • Debt maturitiesComing

    One company's debt due by year, from XBRL

    History: not stated yet

  • Revenue breakdownComing

    Revenue by product, segment and region, from filings

    History: not stated yet

  • GPU rental pricesComing

    Published GPU rental rates and marketplace asks

    History: not stated yet

  • App attentionComing

    App Store and Google Play chart positions

    History: not stated yet

  • Power and gridComing

    Grid interconnection queues and datacentre load requests

    History: not stated yet

  • PerpetualsComing

    Perpetual funding and open interest

    History: not stated yet

  • Supply chainComing

    Supplier and customer links disclosed in filings

    History: not stated yet

Credits per call after the path; ranged reads after the slash. History starts comes from each response's meta.

Every value cited.

Each response names its sources. KPI rows quote the filing they came from.

Example response · data.series[0].latestsynthetic values
{
  "metricId": "revenue",
  "period": {
    "start": "2026-07-01",
    "end": "2026-09-30",
    "kind": "quarter",
    "fiscalYear": 2026,
    "fiscalQuarter": 3,
    "label": "Q3 2026"
  },
  "value": 100,
  "asOf": "2026-09-30T12:00:00.000Z",
  "revision": 1,
  "evidence": [
    {
      "id": "illustrative-evidence-1",
      "documentId": "illustrative-document",
      "sourceId": "illustrative-filing",
      "sourceKind": "filing",
      "url": "https://example.invalid/illustrative-filing",
      "title": "ILLUSTRATIVE filing",
      "publishedAt": "2026-09-30T12:00:00.000Z",
      "country": "US",
      "language": "en",
      "quote": "ILLUSTRATIVE revenue was 100.",
      "quoteOffset": 0,
      "quoteSourceLength": 100,
      "quoteMatchMode": "exact",
      "confidence": 1
    }
  ]
}

Every response carries

meta.source
every source, with attribution and licence
meta.asOf
when the newest value in the response was observed
meta.historyStarts
the earliest stored history, or null
meta.coverage
what the store covers, or null
meta.lastUpdated
when the data was last read from source, or null

Rows carry

KPIs and guidance
evidence[].quote, url, publishedAt
Government awards
sourceUrl, observedAt
8-K events
docUrl, filingDate
US consumer prices
code, the BLS series id
EIA energy inventories
key, the EIA series id
CFTC positioning
contractCode, reportDate

First call in three steps.

  1. 1. Choose a plan, create a key

    export GLOOM_DATASETS_KEY=gds_...

  2. 2. Call a dataset

    curl https://api.gloom.sh/v1/kpis/AAPL \
  -H "Authorization: Bearer $GLOOM_DATASETS_KEY"

  3. 3. Read it in code

    import os, requests

key = os.environ["GLOOM_DATASETS_KEY"]
r = requests.get("https://api.gloom.sh/v1/kpis/AAPL",
    headers={"Authorization": f"Bearer {key}"})
r.json()["meta"]["source"]

Python and TypeScript in the quickstart.

One key. Credits by the call.

PlanPer monthCredits a month
Basic$200$120 founding150,000
Desk$800$480 founding1,000,000
Enterprisefrom $2,000by contract

Founding: 40% off for 12 months, for the first 100 paid accounts or until December 4, 2026, whichever ends first. Pricing →

Built for.

  • Research desks

    Numbers that link to the filing they came from.

  • Data teams

    Point-in-time KPIs with asOf, on every plan.

  • Developers

    One key, JSON and an OpenAPI document.

Questions.

What may I do with the data?
Basic: internal business use. Desk: internal business use. Enterprise: display and redistribution, by contract.
How far back does each dataset go?
As far as the stored data shows, and no further. Every response carries historyStarts and coverage. When the store cannot establish them they are null, and the table above says not stated yet.
What is a credit?
A call costs its type times the dataset class. A lookup is 1, a date range 2, a search page 2, an evidence read 5. Class x1: 8-K events, US consumer prices, EIA energy inventories, CFTC positioning. Class x2: Executive pay, Government awards, KPIs and guidance. X-Credits-Cost says what each call spent.
What happens at the limit?
Calls stop with 429 credits_exhausted until the next period. There is no overage billing, and unused credits do not carry over.
Is there a free tier?
No. Plans start at $200 a month.
How is this different from Gloom Pro and the News API?
Gloom Pro is the live data plan of the Gloomberb terminal, for one person at a screen. Gloom Datasets sells datasets to code, with a licence per plan, and has no quotes, prices or options. Pro does not include Gloom Datasets credits. Both APIs answer on api.gloom.sh, with different keys: a Pro key does not read datasets, and a Gloom Datasets key (gds_) does not read Pro data. The News API stays its own product, with its own key.
Where does the data come from?
U.S. Securities and Exchange Commission and the filing issuerUSAspending.govEuropean Union TEDUK Contracts Finder and Find a TenderGovernment of CanadaGLEIFU.S. Bureau of Labor StatisticsFederal Reserve Bank of St. Louis, original source BLSU.S. Energy Information AdministrationCommodity Futures Trading Commission
Is there an SLA or a SOC 2 report?
No. Neither exists today.
Is this investment advice?
No. It is data with its sources.

Every plan reads every live dataset.Plans start at $200 a month.

See plansRead the docs

Questions: hello@gloom.sh

Need a terminal? Gloom Pro is Gloomberb with live data.gloom.sh/cloud →