# Gloom Finance Terminal – Hiring Expansion Data

> Gloom Finance Terminal – Hiring Expansion Data is a paid API for AI agents from api.gloom.sh, paid per call via x402, $0.24/call, status unknown (last checked 2026-11-01).

Returns structured data about companies expanding into new countries or sectors, identified through hiring signals, for a given week.

## Facts

- Endpoint: GET https://api.gloom.sh/v1/hiring/expansion?utm_source=zero.xyz
- Price: $0.24/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gloom-finance-terminal-hiring-expansion-data-533fc88d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mDa-PcVDdnyvJBMzBmdeC

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability gloom-finance-terminal-hiring-expansion-data-533fc88d
```

Example prompt: Pull the latest hiring-based geographic expansion signals from Gloom and show me which companies are entering new countries this week, including their tickers and sectors.

## When to prefer this

Use this endpoint when you need structured, signal-driven data about which publicly traded companies are expanding into new geographies, derived from hiring activity patterns. It is particularly useful for equity screening, thematic investing research, or monitoring international market entry events on a weekly cadence. Prefer this over general news or filings search when you want a quantified, algorithmically-derived expansion signal tied to specific tickers and countries.

## Known failure modes

- Invalid or malformed properties filter returns empty or error response
- No expansion events available for the requested time period returns empty data array
- Payment failure (402) if USDC payment header is missing or insufficient
- Rate limiting if too many requests are made in a short window
- Stale data if the weekly signal pipeline has not yet updated

## How this service works

Gloom is a free, open-source finance terminal for desktop and TUI with charts, news, filings, portfolios, alerts, and plugins.

## Output

Returns a JSON array of expansion events, each containing a country code, expansion type (e.g. 'new_country'), the week date, group label, human-readable country name, sector, ticker symbol, and dimension category. Example: JBHT expanding into Mexico (MX) in the Industrials sector for the week of 2026-10-12.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "key": "MX",
    "kind": "new_country",
    "week": "2026-10-12",
    "group": "expansion",
    "label": "Mexico",
    "sector": "Industrials",
    "symbol": "JBHT",
    "country": "MX",
    "dimension": "country",
    "sourceTickers": [
     "JBHT"
    ]
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-finance-terminal-hiring-expansion-data-533fc88d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.gloom.sh](https://www.zero.xyz/host/api.gloom.sh/llms.txt)