# Gloom Market Snapshot API

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

Returns a real-time market data snapshot (price, volume, resolved instrument metadata) for one or more financial symbols via GET request.

## Facts

- Endpoint: GET https://api.gloom.sh/v1/market/snapshot?utm_source=zero.xyz
- Price: $0.6/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gloom-market-snapshot-api-aa8fe1e4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_f-mQA-TuaOPLfpAxiwwhM

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-market-snapshot-api-aa8fe1e4
```

Example prompt: Can you pull a live market snapshot for AAPL and MSFT from Gloom — I need the current price, volume, and exchange info for both?

## When to prefer this

Prefer this endpoint when you need fast, real-time price and volume data for one or more equity or ETF symbols and want structured metadata (exchange, currency, asset type) alongside the quote. It is well-suited for portfolio monitoring, pre-trade checks, and enriching financial workflows. It charges per-call via x402/USDC micropayment, making it appropriate for on-demand lookups rather than high-frequency polling. Choose alternatives if you need historical OHLCV data, options chains, or fundamentals.

## Known failure modes

- Missing required 'symbols' or 'fields' query params returns a validation error
- Invalid or unrecognized ticker symbols may return status != 'ok' with error detail in 'error' field
- Payment failure (x402) if USDC balance is insufficient or wallet not configured
- Rate limiting or service downtime may result in HTTP 5xx responses
- Market hours may affect data freshness; after-hours data may be stale or 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 array of per-symbol objects, each containing: resolved instrument metadata (name, ticker, symbol, MIC, currency, exchange, assetType), current price and volume under 'values', status field ('ok' or error), and optional derived/period/currency fields. Errors per symbol are surfaced inline.

## 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",
      "fields"
     ],
     "properties": {
      "fields": {
       "type": "string"
      },
      "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": [
   {
    "error": null,
    "input": "TIP",
    "errors": null,
    "status": "ok",
    "symbol": "AAPL",
    "values": {
     "price": 105.82,
     "volume": 2069454
    },
    "derived": null,
    "periods": null,
    "resolved": {
     "mic": null,
     "name": null,
     "symbol": "TIP",
     "ticker": "TIP",
     "currency": "USD",
     "exchange": "",
     "assetType": "equity"
    },
    "currencies": null
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-market-snapshot-api-aa8fe1e4/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)