# Gloom Perpetuals Market Lookup by Market ID

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

Retrieves details for a specific perpetual futures market by its market ID from the Gloom finance terminal API.

## Facts

- Endpoint: GET https://api.gloom.sh/v1/perps/markets/%7BmarketId%7D?utm_source=zero.xyz
- Price: $0.15/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-market-lookup-by-market-id-4a2d1058
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_htU1MWqALMr3HuSo8YrXn

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-market-lookup-by-market-id-4a2d1058
```

Example prompt: Can you pull up the market details for the BTC perpetual on Hyperliquid — I need to see the venue, base asset, price multiplier, and market ID?

## When to prefer this

Use this endpoint when you need structured metadata for a specific perpetual futures market by its exact market ID (e.g. 'hyperliquid:default:BTC'). Prefer this over listing all markets when you already know the market ID and want precise, low-latency detail retrieval from the Gloom finance terminal's perps data layer.

## Known failure modes

- Invalid or malformed marketId returns an empty data array or 404 error
- Unknown market ID returns no results
- API payment failure (x402 micropayment not completed) results in 402 response
- Rate limiting or service unavailability returns 5xx error

## 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 containing an array with the matched market's details, including: DEX name, venue (e.g. 'hyperliquid'), symbol, market ID, base asset, asset class, display name, price multiplier, underlying symbol, and underlying currency.

## 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": "BTC",
    "marketId": "hyperliquid:default:BTC",
    "baseAsset": "BTC",
    "assetClass": "crypto",
    "displayName": "BTC",
    "priceMultiplier": 1,
    "underlyingSymbol": null,
    "underlyingCurrency": null
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gloom-perpetuals-market-lookup-by-market-id-4a2d1058/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)