--- name: tick.hugen.tokyo description: tick.hugen.tokyo provides real-time tick-level bid/ask quote data for FX pairs and commodities. It exposes three endpoints: symbol discovery, single-symbol latest tick, and a bulk all-symbols tick feed. Data includes spread, source count, quote freshness, and quality state metadata. host: tick.hugen.tokyo --- # tick.hugen.tokyo tick.hugen.tokyo is a narrow-purpose FX and commodity tick data host serving agents that need current best-bid/best-ask prices with quality metadata. It covers instruments such as EURUSD, USDJPY, GBPUSD, and XAUUSD. It does not provide equities, crypto, historical data, or streaming feeds. Its distinguishing feature is multi-source aggregation with explicit quality-state and freshness signals per symbol. ## When to use this host Use tick.hugen.tokyo when an agent needs real-time best-bid/best-ask quotes with spread and data-quality metadata for FX pairs or commodities. Use fetch-latest-tick for targeted single-symbol queries; use fetch-all-tick-data when multiple instruments are needed in one round-trip. Do not use this host for historical price data, OHLCV candles, streaming feeds, equities, or crypto assets — those require a different data provider. If symbol availability is uncertain, call fetch-tick-symbols first to avoid wasted paid requests on unsupported or low-quality symbols. ## Capabilities ### Symbol Discovery Identifies which FX and commodity symbols are available for tick queries and reports their current source count and quality state, allowing agents to validate a symbol before requesting price data. - **`fetch-tick-symbols`** — Returns the list of available market symbols with their fresh source count and quality state for tick-level market data access. ### Real-Time Tick Pricing Retrieves the current best bid, best ask, spread, quote age, and multi-source quality metadata for one or all tracked instruments in a single snapshot call. - **`fetch-latest-tick`** — Returns the most recent bid, ask, spread, and quality metadata for a specified FX or commodity symbol via a paid x402 endpoint. - **`fetch-all-tick-data`** — Returns aggregated tick-level bid/ask quotes, spread, source quality, and freshness metadata for all available FX and commodity instruments in a single request. ## Workflows ### Validated Single-Symbol Price Fetch *Use when an agent needs the current tick price for a symbol but must first confirm the symbol is supported and has acceptable data quality before incurring the cost of a paid tick query.* 1. **`fetch-tick-symbols`** — Retrieve the full symbol directory and check that the target symbol exists with a satisfactory quality_state and fresh_sources count. 2. **`fetch-latest-tick`** — Request the current best bid/ask, spread, and freshness metadata for the validated symbol. ## Skill reference ### `fetch-all-tick-data` **Universal Tick Feed** — Returns aggregated tick-level bid/ask quotes, spread, source quality, and freshness metadata for all available FX and commodity instruments in a single request. *Use when:* Use when an agent needs current best-bid/best-ask prices, spread, quote age, source count, and quality state across all tracked instruments (e.g. EURUSD, GBPUSD, XAUUSD) in one call without specifying a symbol. *Not for:* Do not use when only a single instrument's tick is needed and bandwidth is a concern; consider a per-symbol endpoint if one exists. Not suitable for streaming or historical tick data. **Returns:** Returns a ticks object keyed by symbol (e.g. EURUSD, GBPUSD, XAUUSD) where each entry contains best bid/ask, spread, server timestamp, sequence number, source freshness counts, quality state, crossed flag, quote age, source identifiers, leader mid, and median mid. **Example:** `GET https://tick.hugen.tokyo/tick/all` --- ### `fetch-latest-tick` **TickNow Latest** — Returns the most recent bid, ask, spread, and quality metadata for a specified FX or commodity symbol via a paid x402 endpoint. *Use when:* Use when an agent needs the current best bid/ask price, spread, quote age, and multi-source quality state for an FX pair or commodity (e.g., EURUSD, USDJPY, XAUUSD) before executing a trade or displaying a live price. *Not for:* Do not use for historical price data or streaming price feeds; this is a single-shot latest-tick query only. Not suitable for equity or crypto symbols not supported by the FX feed. **Inputs:** - `symbol` (string) — FX or commodity symbol to query (e.g., EURUSD, USDJPY, XAUUSD). Defaults to EURUSD if omitted. **Returns:** Returns a tick object with best_bid, best_ask, best_spread, server_ts, seq, source quality counts, quality_state, quote_age_ms, leader/median mid prices, and worst bid/ask for the requested symbol. **Example:** `GET https://tick.hugen.tokyo/tick/latest?symbol=EURUSD` --- ### `fetch-tick-symbols` **Tick Symbols Directory** — Returns the list of available market symbols with their fresh source count and quality state for tick-level market data access. *Use when:* Use when an agent needs to discover which forex or commodity symbols are available for tick data queries, or to verify a symbol's data quality before requesting tick-level prices. *Not for:* Do not use to retrieve actual tick prices or quotes; use a tick data endpoint for that. Not suitable for streaming or real-time price feeds. **Returns:** Returns a symbols array of 14 forex and commodity pairs (e.g. EURUSD, XAUUSD), each with fresh_sources count and quality_state string. **Example:** `GET https://tick.hugen.tokyo/tick/symbols` ---