--- name: bazaar-gateway.vercel.app description: bazaar-gateway.vercel.app provides four discrete API skills: a server timestamp service, a crypto market report generator covering BTC/ETH/SOL, a real-time crypto price feed for arbitrary coin lists, and a text translation endpoint. Each skill is a single-shot paid request with no streaming or batch processing. host: bazaar-gateway.vercel.app --- # bazaar-gateway.vercel.app Bazaar Gateway is a small multi-purpose API host serving agents that need lightweight, on-demand access to crypto market data, text translation, or authoritative server time. It covers three unrelated capability areas under one payment gateway, making it useful when an agent needs to combine crypto context with localization or timestamping without integrating multiple separate providers. It does not specialize deeply in any one domain. ## When to use this host Use this host when an agent needs a quick, paid single-shot call for crypto spot prices (any coin), a BTC/ETH/SOL market analysis report, text translation into a known target language, or a trusted server timestamp. Do not use it for real-time streaming price feeds or tick-by-tick data — use a dedicated market data WebSocket provider instead. Do not use the market report skill for coins outside BTC, ETH, and SOL; use fetch-crypto-prices for broader coin coverage. Do not use translate-text when the source language is unknown and detection is required — a provider with language detection (e.g. Google Translate API, DeepL) is more appropriate. The timestamp skill is not suitable for high-frequency polling; use a local system clock or NTP service for that. ## Capabilities ### Server Time Provides a single authoritative UTC timestamp with multiple format variants and timezone metadata, suitable for logging, scheduling checks, or anchoring request timing. - **`fetch-server-timestamp`** — Returns the current server timestamp in multiple formats including UTC ISO 8601, Unix epoch, human-readable display, and date/time breakdowns with timezone metadata. ### Crypto Market Data Delivers both raw spot price statistics for arbitrary coin lists and a structured analytical market report (sentiment, phase, support/resistance, conviction scores) for BTC, ETH, and SOL. - **`fetch-crypto-prices`** — Returns real-time USD prices, market cap, 24h/7d/30d change percentages, 24h volume, and all-time-high context for one or more cryptocurrencies. - **`fetch-crypto-market-report`** — Returns a structured crypto market report covering overall sentiment, market phase, macro factors, and per-coin analysis (BTC, ETH, SOL) with key price levels, risks, and opportunities. ### Text Translation Translates a provided text string into a specified target language, returning the original, translated text, and a response timestamp. - **`translate-text`** — Translates a given text string into a specified target language and returns the original text, translated text, and a timestamp. ## Workflows ### Localized Crypto Market Briefing *Use when an agent needs to deliver a crypto market summary to a user in a language other than English, combining market analysis with translation.* 1. **`fetch-crypto-market-report`** — Retrieve the structured markdown market report covering overall sentiment, macro factors, and BTC/ETH/SOL analysis. 2. **`translate-text`** — Translate the retrieved market report or key takeaway text into the user's target language for localized delivery. ### Timestamped Price Snapshot *Use when an agent needs to record current crypto prices alongside a trusted server timestamp for audit logging, scheduling, or time-anchored reporting.* 1. **`fetch-server-timestamp`** — Fetch the authoritative server UTC timestamp to anchor the snapshot in time. 2. **`fetch-crypto-prices`** — Fetch current spot prices and market statistics for the required coins, pairing them with the retrieved timestamp. ## Skill reference ### `fetch-server-timestamp` **Timestamp API** — Returns the current server timestamp in multiple formats including UTC ISO 8601, Unix epoch, human-readable display, and date/time breakdowns with timezone metadata. *Use when:* Use when an agent needs the current authoritative server time for logging, request timing, scheduling checks, or any operation requiring a trusted UTC timestamp with day/week/year breakdowns. *Not for:* Do not use for high-frequency polling or real-time clock synchronization; this is a single-shot paid request costing ~$0.001 per call. **Returns:** Returns ok=true with the current UTC timestamp in ISO 8601, Unix epoch (seconds and ms), human-readable display, date/time breakdowns, day/week of year, UTC offset, boolean signals (is_utc, dst_active, is_weekend, is_business_hours), and a call_id in _meta. **Example:** `GET https://bazaar-gateway.vercel.app/api/timestamp` --- ### `fetch-crypto-market-report` **Bazaar Crypto Market Report** — Returns a structured crypto market report covering overall sentiment, market phase, macro factors, and per-coin analysis (BTC, ETH, SOL) with key price levels, risks, and opportunities. *Use when:* Use when an agent needs a current crypto market overview including sentiment classification, BTC/ETH/SOL price metrics, ATH distances, support/resistance levels, conviction scores, and a formatted markdown report for a 3-6 month horizon. *Not for:* Do not use for real-time streaming price feeds or tick-by-tick data; use a live market data API instead. Not suitable for coins outside BTC, ETH, and SOL as the report covers only those three assets. **Returns:** Returns ok=true plus an analysis object with overall_sentiment, market_phase, macro_factors, and a coins array for BTC/ETH/SOL each containing sentiment, conviction, key price levels, risks, and opportunities, plus full markdown and plain-text report strings. **Example:** `GET https://bazaar-gateway.vercel.app/api/market-report` --- ### `fetch-crypto-prices` **Bazaar Crypto Price Feed** — Returns real-time USD prices, market cap, 24h/7d/30d change percentages, 24h volume, and all-time-high context for one or more cryptocurrencies. *Use when:* Use when an agent needs current spot prices and market statistics for one or more cryptocurrencies (e.g. bitcoin, ethereum, solana) including percentage changes, volume, and ATH drawdown context. *Not for:* Do not use for historical OHLCV data or candlestick charts; not suitable for streaming price feeds — this is a single-shot snapshot. For trend analysis or AI-generated market insights, use the /api/market-report endpoint instead. **Inputs:** - `coins` (string) — Comma-separated list of CoinGecko coin IDs to fetch prices for. Defaults to bitcoin, ethereum, solana based on observed response. **Returns:** Returns ok=true plus a prices map keyed by coin ID with USD price, market cap, 24h/7d/30d change percentages, 24h volume, ATH and drawdown, plus aggregated market signals and response timing. **Example:** `GET https://bazaar-gateway.vercel.app/api/crypto-prices?coins=bitcoin,ethereum,solana` --- ### `translate-text` **Bazaar Translate Pro** — Translates a given text string into a specified target language and returns the original text, translated text, and a timestamp. *Use when:* Use when an agent needs to programmatically translate a block of text into another language and requires the translated result along with the original text and a response timestamp. *Not for:* Do not use for real-time streaming translation or language detection without a known target language; this endpoint requires an explicit target_language value. **Inputs:** - `text` (string, required) — The source text to be translated. - `target_language` (string, required) — The target language for translation (e.g., a language name or code indicating the desired output language). **Returns:** Returns original_text, translated_text in the requested language, the echoed target_language, and an ISO 8601 timestamp of when the translation occurred. **Example:** `{"text": "Hello, how are you?", "target_language": "French"}` ---