{"uid":"cap_htU1MWqALMr3HuSo8YrXn","slug":"gloom-perpetuals-market-lookup-by-market-id-4a2d1058","name":"Gloom Perpetuals Market Lookup by Market ID","description":"Gloom is a free, open-source finance terminal for desktop and TUI with charts, news, filings, portfolios, alerts, and plugins.","url":"https://api.gloom.sh/v1/perps/markets/%7BmarketId%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"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}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.15","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QGj-eb3_5GPzKpR21f-zl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves details for a specific perpetual futures market by its market ID from the Gloom finance terminal API.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Researching a specific perps instrument","prompt":"What are the full details for the BTC perps market on Hyperliquid — give me the market ID, DEX venue, base asset, asset class, and price multiplier."},{"title":"Validating market metadata for trading bot","prompt":"I need to confirm the asset class and price multiplier for the market with ID 'hyperliquid:default:ETH' before I wire up my trading strategy — can you fetch that from Gloom?"},{"title":"Portfolio dashboard market enrichment","prompt":"I'm building a dashboard and need the display name, underlying symbol, and venue for the perps market with ID 'hyperliquid:default:SOL' — can you look that up?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:57:40.639Z","isFirstParty":false,"canonicalSlug":"gloom-perpetuals-market-lookup-by-market-id-4a2d1058"}