# Gloom

> Gloom is a free, open-source finance terminal. Gloom Pro and Gloom Team add the full data, the MCP server and the REST API; Gloom Datasets sells cited datasets over one REST key.

These pages have a Markdown copy at their URL plus .md, or for `Accept: text/markdown`: the facts page, the docs home, the MCP page, the guides, and the Gloom Datasets pages and docs. https://gloom.sh/llms-full.txt has them all in one file. The other pages linked here (plans, pricing, download, console, the REST and MCP references, terms, privacy) are HTML only.

## About Gloom

- [Facts about Gloom](https://gloom.sh/llm-info?utm_source=llms): what Gloom is, who it is for, its main functions, Gloom Datasets, plans and current prices, and comparisons. Markdown at https://gloom.sh/llm-info.md

## The free terminal

Free, open-source finance terminal. Charts, filings, transcripts, options and news behind keyboard functions, on Mac, Windows, the browser and the terminal.

- [Open the web terminal](https://term.gloom.sh/?utm_source=llms): runs in the browser, no account
- [Download the desktop app](https://gloom.sh/download?utm_source=llms): or install the terminal UI with `curl -fsSL gloom.sh/install | bash` (macOS, Linux), `irm https://gloom.sh/install.ps1 | iex` (Windows, PowerShell) or `bun install -g @gloom-sh/terminal` (Any OS, needs Bun)
- [Docs](https://gloom.sh/docs?utm_source=llms): Markdown at https://gloom.sh/docs.md
- [Source code](https://github.com/gloom-sh/gloomberb): open source

## Gloom Pro and Gloom Team

- [Gloom Pro](https://gloom.sh/cloud?utm_source=llms#pricing): $70 a month, or $630 a year (3 months free), after a 7-day trial. Real-time: Worldwide market data, Options chain, News wire, X feed and social sentiment. Research desk: Earnings call transcripts, Hiring data for every listed company, MCP server for your AI agents, Ask Gloom, Equity diagnostic.
- [Gloom Team](https://gloom.sh/firms?utm_source=llms): from $100 a seat a month, for funds, family offices and desks. Every seat gets Pro, MCP and the REST API.
- [REST API](https://gloom.sh/docs/rest-api?utm_source=llms): the same Gloom Pro key over HTTP

## MCP server

Connect Claude Code, Cursor or Codex to Gloom's research tools: quotes, filings, options flow, insider, 13F and congress trades, macro and news. Endpoint: https://api.gloom.sh/mcp. 70 tools. Creating a key and calling tools need Gloom Pro.

```
claude mcp add --transport http gloom https://api.gloom.sh/mcp
```

- [Finance MCP server](https://gloom.sh/mcp?utm_source=llms): Markdown at https://gloom.sh/mcp.md
- [MCP reference](https://gloom.sh/docs/mcp?utm_source=llms): connect commands, every tool, limits

## Gloom Datasets

Gloom Datasets serves 44 datasets over one REST API at https://api.gloom.sh/v1, every value with its source and dates. A plan reads one band of datasets or all of them; each call spends credits.

### Get a key

Sign in to the [console](https://gloom.sh/datasets/console?utm_source=llms) with a Gloom account and verify your email, then start Free or choose a plan on the [pricing page](https://gloom.sh/datasets/pricing?utm_source=llms), and create a key under Keys. Keys start with `gds_`. Send it as `Authorization: Bearer $GLOOM_DATASETS_KEY`.

### Pay per call, no key (x402)

Agents can skip the key: a dataset call without one answers `402` with x402 payment requirements in the `PAYMENT-REQUIRED` header. Pay $0.03 a credit in USDC on Base with any x402 client and send the same request with `PAYMENT-SIGNATURE`; it settles only when the call answers. [How it works](https://gloom.sh/datasets/docs/x402?utm_source=llms), Markdown at https://gloom.sh/datasets/docs/x402.md.

### Plans

- Reference (prices, fundamentals, calendars, macro, futures and crypto): $49 a month for personal use, $149 for company use
- Filings and research (sEC filings and insiders, transcripts, congress trades, M&A, KPIs and estimates): $99 a month for personal use, $299 for company use
- News and our own data (news, options flow, GPU prices, supply chains, hiring and power): $199 a month for personal use, $799 for company use
- Everything (every dataset, one key): $299 a month for personal use, $1,199 for company use
- Free: every dataset on 10 popular tickers, the last 30 days, 100 calls a day, one key, no card
- Display on your own site or app: from $1,000 a month, by email
- Enterprise (display at scale, redistribution, SLA): from $5,000 a month, annual

Founding offer: 25% off every plan for 12 months, for the first 100 paid accounts or until 4 December 2026.

### Reference

- OpenAPI: https://api.gloom.sh/v1/datasets/openapi.json (the same document at https://gloom.sh/datasets/openapi.json)
- Catalog, no key: https://api.gloom.sh/v1/datasets
- [Docs](https://gloom.sh/datasets/docs?utm_source=llms): quickstart, authentication, credits, errors and one reference page per dataset. Add .md to any docs URL for Markdown, starting at https://gloom.sh/datasets/docs.md
- API catalog (RFC 9727): https://gloom.sh/.well-known/api-catalog

### Datasets

Keyless samples: A trimmed real response, in the same envelope, read from the dataset once a day; meta.sampledAt says when. Limited to 30 sample requests per IP per hour.

- [GPU rental prices](https://gloom.sh/datasets/gpu?utm_source=llms): Alternative data. 4 endpoints, from 4 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/gpu?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/gpu/sample`
- [Supply chain](https://gloom.sh/datasets/supply-chain?utm_source=llms): Alternative data. 3 endpoints, from 8 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/supply-chain?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/supply-chain/sample`
- [Hiring postings](https://gloom.sh/datasets/hiring-jobs?utm_source=llms): Alternative data. 4 endpoints, from 4 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/hiring-jobs?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/hiring-jobs/sample`
- [News](https://gloom.sh/datasets/news?utm_source=llms): News. 4 endpoints, from 2 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/news?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/news/sample`
- [Market prices and company fundamentals](https://gloom.sh/datasets/market-data?utm_source=llms): Market data and fundamentals. 7 endpoints, from 2 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/market-data?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/market-data/sample`
- [Social mentions](https://gloom.sh/datasets/social-mentions?utm_source=llms): Alternative data. 2 endpoints, from 8 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/social-mentions?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/social-mentions/sample`
- [App attention](https://gloom.sh/datasets/app-attention?utm_source=llms): Alternative data. 4 endpoints, from 4 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/app-attention?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/app-attention/sample`
- [Power and grid](https://gloom.sh/datasets/power?utm_source=llms): Alternative data. 4 endpoints, from 4 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/power?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/power/sample`
- [Executive pay](https://gloom.sh/datasets/exec-pay?utm_source=llms): Filings and company text. 2 endpoints, from 2 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/exec-pay?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/exec-pay/sample`
- [Government awards](https://gloom.sh/datasets/awards?utm_source=llms): Macro and positioning. 2 endpoints, from 4 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/awards?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/awards/sample`
- [KPIs and guidance](https://gloom.sh/datasets/kpis-guidance?utm_source=llms): Filings and company text. 2 endpoints, from 2 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/kpis-guidance?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/kpis-guidance/sample`
- [8-K events](https://gloom.sh/datasets/events?utm_source=llms): Filings and company text. 1 endpoint, from 2 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/events?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/events/sample`
- [US consumer prices](https://gloom.sh/datasets/cpi?utm_source=llms): Macro and positioning. 1 endpoint, from 1 credit a call. [Reference](https://gloom.sh/datasets/docs/datasets/cpi?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/cpi/sample`
- [EIA energy inventories](https://gloom.sh/datasets/energy-inventories?utm_source=llms): Macro and positioning. 1 endpoint, from 1 credit a call. [Reference](https://gloom.sh/datasets/docs/datasets/energy-inventories?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/energy-inventories/sample`
- [CFTC positioning](https://gloom.sh/datasets/cot?utm_source=llms): Macro and positioning. 2 endpoints, from 1 credit a call. [Reference](https://gloom.sh/datasets/docs/datasets/cot?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/cot/sample`
- [Hiring momentum](https://gloom.sh/datasets/hiring-momentum?utm_source=llms): Alternative data. 10 endpoints, from 4 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/hiring-momentum?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/hiring-momentum/sample`
- [Credit documents and covenants](https://gloom.sh/datasets/credit-documents?utm_source=llms): Filings and company text. 3 endpoints, from 8 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/credit-documents?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/credit-documents/sample`
- [Perpetuals](https://gloom.sh/datasets/perps?utm_source=llms): Alternative data. 6 endpoints, from 1 credit a call. [Reference](https://gloom.sh/datasets/docs/datasets/perps?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/perps/sample`
- [Catalysts and litigation](https://gloom.sh/datasets/catalysts?utm_source=llms): Alternative data. 3 endpoints, from 1 credit a call. [Reference](https://gloom.sh/datasets/docs/datasets/catalysts?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/catalysts/sample`
- [Exposure engine](https://gloom.sh/datasets/exposure?utm_source=llms): Alternative data. 2 endpoints, from 2 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/exposure?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/exposure/sample`
- [Earnings-call transcripts](https://gloom.sh/datasets/transcripts?utm_source=llms): Filings and company text. 2 endpoints, from 4 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/transcripts?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/transcripts/sample`
- [Risk factors](https://gloom.sh/datasets/risk-factors?utm_source=llms): Filings and company text. 2 endpoints, from 2 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/risk-factors?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/risk-factors/sample`
- [Document search](https://gloom.sh/datasets/document-search?utm_source=llms): Filings and company text. 2 endpoints, from 4 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/document-search?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/document-search/sample`
- [FINRA short volume](https://gloom.sh/datasets/short-volume?utm_source=llms): Macro and positioning. 1 endpoint, from 2 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/short-volume?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/short-volume/sample`
- [FINRA short interest](https://gloom.sh/datasets/short-interest?utm_source=llms): Macro and positioning. 1 endpoint, from 2 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/short-interest?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/short-interest/sample`
- [SEC filings, insiders and 13F holders](https://gloom.sh/datasets/sec?utm_source=llms): Filings and company text. 8 endpoints, from 1 credit a call. [Reference](https://gloom.sh/datasets/docs/datasets/sec?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/sec/sample`
- [Congress trades](https://gloom.sh/datasets/congress?utm_source=llms): Alternative data. 1 endpoint, from 2 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/congress?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/congress/sample`
- [Yield curves and macro series](https://gloom.sh/datasets/macro?utm_source=llms): Macro and positioning. 4 endpoints, from 1 credit a call. [Reference](https://gloom.sh/datasets/docs/datasets/macro?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/macro/sample`
- [Central bank rates](https://gloom.sh/datasets/central-bank-rates?utm_source=llms): Macro and positioning. 1 endpoint, from 2 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/central-bank-rates?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/central-bank-rates/sample`
- [Credit default swaps](https://gloom.sh/datasets/cds?utm_source=llms): Macro and positioning. 4 endpoints, from 4 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/cds?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/cds/sample`
- [Debt maturities](https://gloom.sh/datasets/debt-maturities?utm_source=llms): Filings and company text. 1 endpoint, from 4 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/debt-maturities?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/debt-maturities/sample`
- [Revenue breakdown](https://gloom.sh/datasets/revenue-breakdown?utm_source=llms): Filings and company text. 1 endpoint, from 4 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/revenue-breakdown?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/revenue-breakdown/sample`
- [Depositary receipts (ADR reference)](https://gloom.sh/datasets/depositary-receipts?utm_source=llms): Market data and fundamentals. 2 endpoints, from 2 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/depositary-receipts?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/depositary-receipts/sample`
- [Corporate bond trades](https://gloom.sh/datasets/bond-trades?utm_source=llms): Market data and fundamentals. 2 endpoints, from 4 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/bond-trades?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/bond-trades/sample`
- [Futures curves, archives and generics](https://gloom.sh/datasets/futures?utm_source=llms): Market data and fundamentals. 3 endpoints, from 4 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/futures?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/futures/sample`
- [Rate path](https://gloom.sh/datasets/rate-path?utm_source=llms): Market data and fundamentals. 1 endpoint, from 50 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/rate-path?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/rate-path/sample`
- [Options flow, chains and implied volatility](https://gloom.sh/datasets/options?utm_source=llms): Market data and fundamentals. 5 endpoints, from 4 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/options?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/options/sample`
- [Earnings calendar and moves](https://gloom.sh/datasets/earnings?utm_source=llms): Market data and fundamentals. 2 endpoints, from 4 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/earnings?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/earnings/sample`
- [IPO calendar](https://gloom.sh/datasets/ipo?utm_source=llms): Market data and fundamentals. 1 endpoint, from 4 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/ipo?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/ipo/sample`
- [Mergers and acquisitions](https://gloom.sh/datasets/mna?utm_source=llms): Market data and fundamentals. 2 endpoints, from 4 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/mna?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/mna/sample`
- [Equity screener](https://gloom.sh/datasets/equity-screener?utm_source=llms): Market data and fundamentals. 1 endpoint, from 4 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/equity-screener?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/equity-screener/sample`
- [Digital asset markets](https://gloom.sh/datasets/crypto?utm_source=llms): Market data and fundamentals. 1 endpoint, from 50 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/crypto?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/crypto/sample`
- [Session movers, highs/lows and tape](https://gloom.sh/datasets/session-tape?utm_source=llms): Market data and fundamentals. 3 endpoints, from 4 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/session-tape?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/session-tape/sample`
- [Analyst estimates and revisions](https://gloom.sh/datasets/analyst-estimates?utm_source=llms): Market data and fundamentals. 2 endpoints, from 4 credits a call. [Reference](https://gloom.sh/datasets/docs/datasets/analyst-estimates?utm_source=llms). Keyless sample: `curl https://api.gloom.sh/v1/datasets/analyst-estimates/sample`

## Guides

- [Alternative data for funds](https://gloom.sh/alternative-data?utm_source=llms): Job postings and hiring, GPU rental prices, supply chains, options flow and more. In the terminal on Gloom Pro, or by API with Gloom Datasets.
- [GPU price API](https://gloom.sh/gpu-price-api?utm_source=llms): GPU rental prices, list indexes and price history over one REST key: H100, H200, B200 and more. Try the sample without a key. From $199/mo.
- [Options flow API](https://gloom.sh/options-flow-api?utm_source=llms): Stored options flow, implied volatility surfaces, option chains and dealer gamma over one REST key. Try the sample without a key. From $199/mo.
- [Earnings call transcripts API](https://gloom.sh/earnings-call-transcripts-api?utm_source=llms): Earnings call transcripts over one REST key: speaker turns, the analyst Q&A, summary and guidance, plus search. Try the sample free. From $99/mo.
- [Company suppliers and customers](https://gloom.sh/features/supply-chain-data?utm_source=llms): Who NVIDIA, Apple, TSMC and Tesla buy from and sell to, with the filing behind each link. Try SPLC free in the terminal; Pro and the API show them all.
- [Options flow, sweep by sweep](https://gloom.sh/features/options-flow?utm_source=llms): The day's option sweeps, blocks and big premium prints, for the whole market or one stock, with strikes and the net premium tide. Try Gloom free.

## Optional

- [Full text](https://gloom.sh/llms-full.txt): every Markdown page in one file
- [Gloom Datasets terms](https://gloom.sh/datasets/terms?utm_source=llms)
- [Terms](https://gloom.sh/terms?utm_source=llms)
- [Privacy](https://gloom.sh/privacy?utm_source=llms)