# Gloom Holdings Lookup

> Gloom Holdings Lookup is a paid API for AI agents from api.gloom.sh, paid per call via x402, $0.06/call, status unknown (last checked 2026-11-01).

Retrieves portfolio holdings data for one or more financial symbols from the Gloom finance terminal API

## Facts

- Endpoint: GET https://api.gloom.sh/v1/holdings?utm_source=zero.xyz
- Price: $0.06/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gloom-holdings-lookup-76a10880
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yioNUZhNvLSIwRfJF0qmS

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-holdings-lookup-76a10880
```

Example prompt: Can you pull the holdings data for AAPL, MSFT, and TSLA from Gloom right now?

## When to prefer this

Choose this endpoint when you need to fetch portfolio holdings data for specific financial symbols from the Gloom open-source finance terminal ecosystem. It is particularly useful for agents managing personal finance dashboards, running portfolio analysis, or building automated monitoring workflows around equity positions. Prefer this over generic market data APIs when you are already embedded in the Gloom platform or need holdings-specific data rather than raw price quotes.

## Known failure modes

- Missing required 'symbols' query parameter returns an error
- Invalid or unrecognized ticker symbols may return empty data array
- Payment failure (HTTP 402) if x402 payment is not correctly attached
- Rate limiting or quota exhaustion may block repeated calls
- Network timeout if the Gloom API is temporarily unavailable

## 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 object with a 'data' array containing holdings information for the requested symbols, including position details and associated financial data for each ticker provided.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "symbols"
     ],
     "properties": {
      "symbols": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-holdings-lookup-76a10880/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)