# Gloom Perpetuals Markets Listing

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

Returns a list of available perpetual futures markets across decentralized exchanges, including symbols, venues, asset classes, and market identifiers.

## Facts

- Endpoint: GET https://api.gloom.sh/v1/perps/markets?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gloom-perpetuals-markets-listing-9d88b9c9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_orMgKLtftG1tsFpQMyZo9

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-perpetuals-markets-listing-9d88b9c9
```

Example prompt: Pull the full list of available perpetual futures markets from Gloom so I can see which symbols and venues like Hyperliquid are currently supported.

## When to prefer this

Use this endpoint when you need a structured, machine-readable list of all perpetual futures markets aggregated by Gloom, especially when building DeFi trading tools, dashboards, or agents that need to enumerate supported venues and symbols. Prefer this over scraping exchange UIs or calling individual DEX APIs directly when Gloom's aggregated multi-venue coverage is sufficient.

## Known failure modes

- Payment not included or insufficient (HTTP 402) — x402 micropayment of 0.03 USDC required per call
- Empty data array if no markets are currently indexed
- Malformed properties filter causes unexpected empty or error response
- Upstream DEX venue (e.g. Hyperliquid) data unavailable, resulting in partial or stale market list

## 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

A JSON array of perpetual futures market objects, each containing: dex, venue (e.g. 'hyperliquid'), symbol (e.g. 'ETH'), marketId (e.g. 'hyperliquid:default:ETH'), baseAsset, assetClass (e.g. 'crypto'), displayName, priceMultiplier, underlyingSymbol, and underlyingCurrency.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "dex": "default",
    "venue": "hyperliquid",
    "symbol": "ETH",
    "marketId": "hyperliquid:default:ETH",
    "baseAsset": "ETH",
    "assetClass": "crypto",
    "displayName": "ETH",
    "priceMultiplier": 1,
    "underlyingSymbol": null,
    "underlyingCurrency": null
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-perpetuals-markets-listing-9d88b9c9/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)