# Gloom Market Quotes API

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

Fetches real-time market quotes including price, bid, change, and change percent for one or more ticker symbols

## Facts

- Endpoint: GET https://api.gloom.sh/v1/market/quotes?utm_source=zero.xyz
- Price: $0.12/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-quotes-api-33830127
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jRQDPo6dEswxO4_kCZs7L

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-quotes-api-33830127
```

Example prompt: What's the current market quote for AAPL and MSFT — give me the price, bid, and today's change?

## When to prefer this

Choose this endpoint when you need real-time or near-real-time market quotes for equities or ETFs by ticker symbol, especially within the Gloom ecosystem or when you want a low-cost per-call pricing model. Prefer it over heavier financial data APIs when you only need current price, bid, and change data without historical time series or fundamentals.

## Known failure modes

- Invalid or unrecognized ticker symbol returns an error field in the quote object with status other than 'ok'
- Missing 'symbols' query parameter causes a 400-level error
- Network timeout or upstream data provider outage returns a service error
- Payment failure (insufficient USDC balance or x402 auth issue) blocks the request
- Symbols for non-equity or unsupported asset types may return null fields for exchange or MIC

## 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 an array of quote objects per symbol, each containing price, bid, change, change percent, currency, resolved ticker details (symbol, name, exchange, asset type, MIC), and a status field indicating success or error per symbol.

## 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": [
   {
    "error": null,
    "input": "TIP",
    "quote": {
     "bid": 105.8,
     "price": 105.82,
     "change": -0.02,
     "symbol": "TIP",
     "currency": "USD",
     "changePercent": -0.0188964474679
    },
    "status": "ok",
    "symbol": null,
    "resolved": {
     "mic": null,
     "name": null,
     "symbol": "TIP",
     "ticker": "TIP",
     "exchange": "",
     "assetType": "equity"
    }
   }
  ]
 }
}
```

## More

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