# tick.hugen.tokyo FX Tick Data API

> tick.hugen.tokyo FX Tick Data API is a paid API for AI agents from tick.hugen.tokyo, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15, last successful call 2026-06-01).

Returns real-time best bid/ask prices for a specified FX pair, aggregated from multiple institutional liquidity providers with spread quality metadata

## Facts

- Endpoint: GET https://tick.hugen.tokyo/tick/latest
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Last successful call: 2026-06-01
- Success rate: 100% of calls made through Zero
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tick-hugen-tokyo-cb6ab3b5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_st5kjj8NTTBeq7bbl6sa_

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 tick-hugen-tokyo-cb6ab3b5
```

Example prompt: Can you get me the current best bid and ask for EURUSD right now, including the spread quality and how many fresh sources are behind it?

## When to prefer this

Use this endpoint when you need tightly aggregated institutional FX prices with spread quality metadata — particularly useful for AI trading signals, portfolio mark-to-market valuation, spread arbitrage detection, or any application where knowing source freshness and spread quality relative to single-source feeds matters. Prefer over single-source FX APIs when spread tightness and multi-source confidence are important.

## Known failure modes

- Invalid or unsupported symbol returns error — only 14 pairs supported (EURUSD, USDJPY, GBPUSD, AUDUSD, AUDNZD, XAUUSD, etc.)
- Payment failure (USDC not provided or insufficient) results in 402 Payment Required
- All sources stale may result in degraded quality_state or no fresh quotes
- Network timeout if liquidity providers are unreachable
- Crossed market (is_crossed: true) indicates unusual spread condition

## How this service works

Get real-time Best Bid/Ask for any FX pair, aggregated from multiple institutional liquidity providers. 62-88% tighter spreads than any single source. Includes quality metadata (fresh_sources, quality_state, spread_vs_single_source). Supports 14 FX pairs including EURUSD, USDJPY, GBPUSD, AUDUSD, AUDNZD, and XAUUSD. AI agent API for forex trading signals, portfolio valuation, price comparison, and arbitrage detection. Accepts USDC payments on Base and Solana

## Output

Returns a JSON object with the aggregated best bid and ask prices, spread, sequence number, leader source, median and leader mid prices, quote age in milliseconds, number of fresh vs stale sources, quality state (e.g. 'degraded' or 'good'), and the spread improvement percentage versus using a single source alone.

## Example request

```json
{
 "symbol": "EURUSD"
}
```

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "required": [
    "method"
   ]
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "seq": 42857,
  "symbol": "EURUSD",
  "best_ask": "1.15919",
  "best_bid": "1.15918",
  "is_crossed": false,
  "best_spread": "0.00001",
  "fresh_sources": 2,
  "quality_state": "good",
  "spread_vs_single_source": "-73.8%"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tick-hugen-tokyo-cb6ab3b5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tick.hugen.tokyo](https://www.zero.xyz/host/tick.hugen.tokyo/llms.txt)