{"uid":"cap_f-mQA-TuaOPLfpAxiwwhM","slug":"gloom-market-snapshot-api-aa8fe1e4","name":"Gloom Market Snapshot API","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/market/snapshot?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.6","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.6/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.6","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.6","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_w2VmRR1JDYB3HAwh3pWqg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.6","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a real-time market data snapshot (price, volume, resolved instrument metadata) for one or more financial symbols via GET request.","exampleAgentPrompt":"Can you pull a live market snapshot for AAPL and MSFT from Gloom — I need the current price, volume, and exchange info for both?","exampleUseCases":[{"title":"Portfolio price check at open","prompt":"I want to quickly check the current price and volume for all my holdings — AAPL, TSLA, and SPY — before the market moves. Can you grab a snapshot for those three tickers?"},{"title":"ETF research and metadata lookup","prompt":"I'm trying to figure out what exchange TIP is listed on and what currency it trades in — can you pull the market snapshot for TIP so I can see the asset type and resolved instrument info?"},{"title":"Automated price alert baseline","prompt":"Before I set up my price alerts, can you get me the current market price and volume for NVDA so I have a baseline to compare against?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:57:43.356Z","isFirstParty":false,"canonicalSlug":"gloom-market-snapshot-api-aa8fe1e4"}