# Ichimoku Cloud API > The Ichimoku Kinko Hyo ("one-glance equilibrium chart") for any stock, index, FX pair, commodity or crypto, computed live from Yahoo Finance daily, weekly or monthly candles, no key. Ichimoku is a complete Japanese trend system, not a single line: five components — Tenkan-sen (conversion), Kijun-sen (base), Senkou Span A and B (which form the Kumo cloud) and the Chikou (lagging) span — together give a one-glance read on trend, momentum and support/resistance. Its defining feature is the cloud, projected 26 periods into the future, that acts as forward support and resistance. The ichimoku endpoint returns the full current reading for a symbol: all five lines, the current cloud (top, bottom and colour), where price sits relative to the cloud, the Tenkan/Kijun cross, the Chikou confirmation and an overall signal — plus the forward-projected cloud. The history endpoint returns the recent series of the lines for charting. Everything is computed with the correct time-shifts: the current cloud uses the leading spans as they were plotted 26 periods ago (the cloud price sits in today), and the forward cloud is today's leading spans projected ahead — the distinction many naive implementations get wrong. This is the Ichimoku system cut — distinct from the single-indicator feeds in the catalogue (SuperTrend, Keltner, Donchian, MACD, RSI). Levels are in the instrument's own price; signals are mechanical reads of the lines, not advice. Conversion, base, leading-B and displacement periods are all overridable. Keyless, nothing stored beyond a short cache. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/ichimoku-api/..." ``` ## Pricing - **Free** (Free) — 1,150 calls/Mo, 2 req/s - **Starter** ($17/Mo) — 57,000 calls/Mo, 6 req/s - **Pro** ($45/Mo) — 385,000 calls/Mo, 16 req/s - **Scale** ($99/Mo) — 2,350,000 calls/Mo, 40 req/s ## Endpoints ### Ichimoku #### `GET /v1/ichimoku` — Full Ichimoku reading for a symbol **Parameters:** - `symbol` (query, required, string) — Yahoo ticker (AAPL, EURUSD=X, BTC-USD, ^GSPC) Example: `AAPL` - `interval` (query, optional, string) — 1d, 1wk or 1mo Example: `1d` - `conversion` (query, optional, string) — Tenkan period (default 9) Example: `9` - `base` (query, optional, string) — Kijun period (default 26) Example: `26` - `leading_b` (query, optional, string) — Senkou B period (default 52) Example: `52` - `displacement` (query, optional, string) — Cloud shift (default 26) Example: `26` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/ichimoku-api/v1/ichimoku?symbol=AAPL&interval=1d&conversion=9&base=26&leading_b=52&displacement=26" ``` **Response:** ```json { "data": { "note": "The full Ichimoku Kinko Hyo reading for AAPL on the 1d timeframe. cloud is the current Kumo (the leading spans as plotted today, i.e. computed 26 periods ago — the cloud price sits in); forward_cloud is today's leading spans projected 26 periods ahead (forward support/resistance). signals.price_vs_cloud, tenkan_kijun and chikou are the three mechanical reads; overall is their majority. Levels are in the instrument's own price (USD). Mechanical indicator reads, not advice. Live, cached ~5m.", "as_of": "2026-06-12", "cloud": { "top": 271.7075, "color": "bullish", "bottom": 266.77, "senkou_a": 271.7075, "senkou_b": 266.77 }, "price": 291.13, "params": { "base": 26, "leading_b": 52, "conversion": 9, "displacement": 26 }, "source": "Yahoo Finance chart candles (query1.finance.yahoo.com), keyless", "symbol": "AAPL", "signals": { "chikou": "bullish", "overall": "bullish", "tenkan_kijun": "bullish", "price_vs_cloud": "above" }, "currency": "USD", "interval": "1d", "kijun_sen": 301.59, "tenkan_sen": 302.39, "chikou_span": 291.13, "forward_cloud": { "color": "bullish", "senkou_a": 301.99, "senkou_b": 281.55, "projected_period …(truncated, see openapi.json for full schema) ``` ### History #### `GET /v1/history` — Recent Ichimoku line series for charting **Parameters:** - `symbol` (query, required, string) — Yahoo ticker Example: `AAPL` - `interval` (query, optional, string) — 1d, 1wk or 1mo Example: `1d` - `limit` (query, optional, string) — Rows (1-250) Example: `60` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/ichimoku-api/v1/history?symbol=AAPL&interval=1d&limit=60" ``` **Response:** ```json { "data": { "note": "The recent Ichimoku line series for charting — for each period the close, Tenkan-sen, Kijun-sen and the current Kumo cloud spans (Senkou A/B as plotted at that date, i.e. shifted in from 26 periods earlier). Pass limit (1-250). Live, cached ~5m.", "count": 60, "series": [ { "date": "2026-03-19", "close": 248.96, "senkou_a": 264.355, "senkou_b": 266.02, "kijun_sen": 263.74, "tenkan_sen": 254.89 }, { "date": "2026-03-20", "close": 247.99, "senkou_a": 264.355, "senkou_b": 266.02, "kijun_sen": 261.055, "tenkan_sen": 254.24 }, { "date": "2026-03-23", "close": 251.49, "senkou_a": 266.1125, "senkou_b": 266.02, "kijun_sen": 261.055, "tenkan_sen": 254.065 }, { "date": "2026-03-24", "close": 251.64, "senkou_a": 265.1725, "senkou_b": 266.02, "kijun_sen": 261.055, "tenkan_sen": 252.475 }, { "date": "2026-03-25", "close": 252.62, "senkou_a": 265.1725, "senkou_b": 266.02, "kijun …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Service metadata **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/ichimoku-api/v1/meta" ``` **Response:** ```json { "data": { "note": "ichimoku and history take symbol (a Yahoo ticker like AAPL, EURUSD=X, BTC-USD, ^GSPC), interval (1d/1wk/1mo, default 1d) and optional params conversion (9), base (26), leading_b (52), displacement (26). history also takes limit (1-250). meta takes no parameters. Levels are in the instrument's own price; signals are mechanical, not advice. A short ~5-minute cache fronts Yahoo.", "sample": { "price": 291.13, "symbol": "AAPL", "overall": "bullish" }, "source": "Yahoo Finance chart candles (query1.finance.yahoo.com), keyless, live", "service": "ichimoku-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/history": "Recent Ichimoku line series for charting (symbol=AAPL, limit=60).", "GET /v1/ichimoku": "Full Ichimoku reading for a symbol (symbol=AAPL, interval=1d)." }, "description": "The Ichimoku Kinko Hyo for any stock, index, FX pair, commodity or crypto, computed live from Yahoo Finance, no key. Ichimoku is a complete Japanese trend system (Tenkan, Kijun, Senkou A/B forming the Kumo cloud, and Chikou). The ichimoku endpoint gives the full current reading — all five lines, the current and forward cloud, price-vs-cloud, the Tenkan/Kijun cross, Chikou confirmation and an overall signal; history returns the recent line series for charting. The cloud is computed with the correct time-shifts. The Ichimoku syste …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/ichimoku-api OpenAPI spec: https://www.oanor.com/api/ichimoku-api/openapi.json