{"openapi":"3.1.0","info":{"title":"Ichimoku Cloud API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/ichimoku-api","description":"oanor gateway"}],"tags":[{"name":"Ichimoku"},{"name":"History"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/ichimoku":{"get":{"operationId":"get_v1_ichimoku","tags":["Ichimoku"],"summary":"Full Ichimoku reading for a symbol","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Yahoo ticker (AAPL, EURUSD=X, BTC-USD, ^GSPC)","schema":{"type":"string"},"example":"AAPL"},{"name":"interval","in":"query","required":false,"description":"1d, 1wk or 1mo","schema":{"type":"string"},"example":"1d"},{"name":"conversion","in":"query","required":false,"description":"Tenkan period (default 9)","schema":{"type":"string"},"example":"9"},{"name":"base","in":"query","required":false,"description":"Kijun period (default 26)","schema":{"type":"string"},"example":"26"},{"name":"leading_b","in":"query","required":false,"description":"Senkou B period (default 52)","schema":{"type":"string"},"example":"52"},{"name":"displacement","in":"query","required":false,"description":"Cloud shift (default 26)","schema":{"type":"string"},"example":"26"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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_periods_ahead":26}},"meta":{"timestamp":"2026-06-13T04:42:13.338Z","request_id":"01f3104c-ba3a-4380-a2a9-21354d71f961"},"status":"ok","message":"Ichimoku retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/history":{"get":{"operationId":"get_v1_history","tags":["History"],"summary":"Recent Ichimoku line series for charting","description":"","parameters":[{"name":"symbol","in":"query","required":true,"description":"Yahoo ticker","schema":{"type":"string"},"example":"AAPL"},{"name":"interval","in":"query","required":false,"description":"1d, 1wk or 1mo","schema":{"type":"string"},"example":"1d"},{"name":"limit","in":"query","required":false,"description":"Rows (1-250)","schema":{"type":"string"},"example":"60"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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_sen":261.055,"tenkan_sen":251.165},{"date":"2026-03-26","close":252.89,"senkou_a":265.1725,"senkou_b":266.02,"kijun_sen":261.055,"tenkan_sen":251.5},{"date":"2026-03-27","close":248.8,"senkou_a":265.1725,"senkou_b":264.075,"kijun_sen":261.055,"tenkan_sen":251.5},{"date":"2026-03-30","close":246.63,"senkou_a":264.99,"senkou_b":262.28,"kijun_sen":260.81,"tenkan_sen":251.255},{"date":"2026-03-31","close":253.79,"senkou_a":264.99,"senkou_b":262.165,"kijun_sen":260.81,"tenkan_sen":251.255},{"date":"2026-04-01","close":255.63,"senkou_a":264.99,"senkou_b":262.165,"kijun_sen":260.81,"tenkan_sen":251.255},{"date":"2026-04-02","close":255.92,"senkou_a":263.875,"senkou_b":262.165,"kijun_sen":260.81,"tenkan_sen":251.255},{"date":"2026-04-06","close":258.86,"senkou_a":264.2875,"senkou_b":262.165,"kijun_sen":259.16,"tenkan_sen":253.835},{"date":"2026-04-07","close":253.5,"senkou_a":264.31,"senkou_b":262.165,"kijun_sen":256.02,"tenkan_sen":253.835},{"date":"2026-04-08","close":258.9,"senkou_a":264.965,"senkou_b":262.165,"kijun_sen":255.83,"tenkan_sen":253.835},{"date":"2026-04-09","close":260.49,"senkou_a":266.245,"senkou_b":262.165,"kijun_sen":255.83,"tenkan_sen":253.835},{"date":"2026-04-10","close":260.48,"senkou_a":266.84,"senkou_b":262.165,"kijun_sen":253.995,"tenkan_sen":253.85},{"date":"2026-04-13","close":259.2,"senkou_a":266.6125,"senkou_b":262.165,"kijun_sen":253.995,"tenkan_sen":253.945},{"date":"2026-04-14","close":258.83,"senkou_a":265.8925,"senkou_b":262.165,"kijun_sen":253.995,"tenkan_sen":253.945},{"date":"2026-04-15","close":266.43,"senkou_a":265.72,"senkou_b":262.165,"kijun_sen":256.035,"tenkan_sen":256.13},{"date":"2026-04-16","close":263.4,"senkou_a":266.095,"senkou_b":262.165,"kijun_sen":256.335,"tenkan_sen":256.43},{"date":"2026-04-17","close":270.23,"senkou_a":265.27,"senkou_b":262.165,"kijun_sen":258.905,"tenkan_sen":259},{"date":"2026-04-20","close":273.05,"senkou_a":263.7,"senkou_b":262.165,"kijun_sen":259.895,"tenkan_sen":265.175},{"date":"2026-04-21","close":266.17,"senkou_a":261.525,"senkou_b":262.165,"kijun_sen":259.895,"tenkan_sen":265.175},{"date":"2026-04-22","close":273.17,"senkou_a":261.525,"senkou_b":262.165,"kijun_sen":259.895,"tenkan_sen":265.47},{"date":"2026-04-23","close":273.43,"senkou_a":260.425,"senkou_b":262.165,"kijun_sen":260.64,"tenkan_sen":266.215},{"date":"2026-04-24","close":271.06,"senkou_a":260.165,"senkou_b":262.165,"kijun_sen":260.64,"tenkan_sen":266.48},{"date":"2026-04-27","close":267.61,"senkou_a":259.315,"senkou_b":262.165,"kijun_sen":260.64,"tenkan_sen":266.79},{"date":"2026-04-28","close":270.71,"senkou_a":257.6475,"senkou_b":262.165,"kijun_sen":260.64,"tenkan_sen":268.52},{"date":"2026-04-29","close":270.17,"senkou_a":257.56,"senkou_b":262.165,"kijun_sen":260.64,"tenkan_sen":270.42},{"date":"2026-04-30","close":271.35,"senkou_a":256.765,"senkou_b":262.165,"kijun_sen":260.755,"tenkan_sen":270.535},{"date":"2026-05-01","close":280.14,"senkou_a":256.11,"senkou_b":262.165,"kijun_sen":266.365,"tenkan_sen":276.145},{"date":"2026-05-04","close":276.83,"senkou_a":256.2775,"senkou_b":262.165,"kijun_sen":266.365,"tenkan_sen":276.145},{"date":"2026-05-05","close":284.18,"senkou_a":256.2775,"senkou_b":262.165,"kijun_sen":266.365,"tenkan_sen":276.145},{"date":"2026-05-06","close":287.51,"senkou_a":256.0325,"senkou_b":262.165,"kijun_sen":266.865,"tenkan_sen":276.55},{"date":"2026-05-07","close":287.44,"senkou_a":256.0325,"senkou_b":262.165,"kijun_sen":268.915,"tenkan_sen":278.6},{"date":"2026-05-08","close":293.32,"senkou_a":256.0325,"senkou_b":262.165,"kijun_sen":270.23,"tenkan_sen":280.9},{"date":"2026-05-11","close":292.68,"senkou_a":256.0325,"senkou_b":262.165,"kijun_sen":270.23,"tenkan_sen":280.9},{"date":"2026-05-12","close":294.8,"senkou_a":256.4975,"senkou_b":262.795,"kijun_sen":270.485,"tenkan_sen":281.705},{"date":"2026-05-13","close":298.87,"senkou_a":254.9275,"senkou_b":262.795,"kijun_sen":278.495,"tenkan_sen":287.89},{"date":"2026-05-14","close":298.21,"senkou_a":254.8325,"senkou_b":262.795,"kijun_sen":278.495,"tenkan_sen":287.89},{"date":"2026-05-15","close":300.23,"senkou_a":254.8325,"senkou_b":263.21,"kijun_sen":279.93,"tenkan_sen":289.85},{"date":"2026-05-18","close":297.84,"senkou_a":253.9225,"senkou_b":263.21,"kijun_sen":279.93,"tenkan_sen":292.135},{"date":"2026-05-19","close":298.97,"senkou_a":253.97,"senkou_b":263.21,"kijun_sen":280.195,"tenkan_sen":294.49},{"date":"2026-05-20","close":302.25,"senkou_a":253.97,"senkou_b":263.21,"kijun_sen":280.505,"tenkan_sen":296.6},{"date":"2026-05-21","close":304.99,"senkou_a":256.0825,"senkou_b":263.21,"kijun_sen":283.405,"tenkan_sen":297.885},{"date":"2026-05-22","close":308.82,"senkou_a":256.3825,"senkou_b":263.21,"kijun_sen":288.235,"tenkan_sen":301.98},{"date":"2026-05-26","close":308.33,"senkou_a":258.9525,"senkou_b":263.21,"kijun_sen":288.445,"tenkan_sen":302.66},{"date":"2026-05-27","close":310.85,"senkou_a":262.535,"senkou_b":263.21,"kijun_sen":289.165,"tenkan_sen":304.085},{"date":"2026-05-28","close":312.51,"senkou_a":262.535,"senkou_b":263.21,"kijun_sen":289.165,"tenkan_sen":304.085},{"date":"2026-05-29","close":312.06,"senkou_a":262.6825,"senkou_b":263.21,"kijun_sen":290.035,"tenkan_sen":304.955},{"date":"2026-06-01","close":306.31,"senkou_a":263.4275,"senkou_b":262.845,"kijun_sen":290.035,"tenkan_sen":305.675},{"date":"2026-06-02","close":315.2,"senkou_a":263.56,"senkou_b":262.845,"kijun_sen":290.26,"tenkan_sen":306.765},{"date":"2026-06-03","close":310.26,"senkou_a":263.715,"senkou_b":262.845,"kijun_sen":291.99,"tenkan_sen":308.67},{"date":"2026-06-04","close":311.23,"senkou_a":264.58,"senkou_b":260.81,"kijun_sen":291.99,"tenkan_sen":310.98},{"date":"2026-06-05","close":307.34,"senkou_a":265.53,"senkou_b":260.81,"kijun_sen":292.54,"tenkan_sen":310.98},{"date":"2026-06-08","close":301.54,"senkou_a":265.645,"senkou_b":260.81,"kijun_sen":296.13,"tenkan_sen":309.285},{"date":"2026-06-09","close":290.55,"senkou_a":271.255,"senkou_b":266.365,"kijun_sen":296.13,"tenkan_sen":302.59},{"date":"2026-06-10","close":291.58,"senkou_a":271.255,"senkou_b":266.365,"kijun_sen":296.95,"tenkan_sen":302.39},{"date":"2026-06-11","close":295.63,"senkou_a":271.255,"senkou_b":266.365,"kijun_sen":299.235,"tenkan_sen":302.39},{"date":"2026-06-12","close":291.13,"senkou_a":271.7075,"senkou_b":266.77,"kijun_sen":301.59,"tenkan_sen":302.39}],"source":"Yahoo Finance chart candles (query1.finance.yahoo.com), keyless","symbol":"AAPL","currency":"USD","interval":"1d"},"meta":{"timestamp":"2026-06-13T04:42:13.440Z","request_id":"8faf6451-781d-4e5c-be93-4a0b6714bd86"},"status":"ok","message":"History retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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 system cut — distinct from the single-indicator feeds (SuperTrend, Keltner, Donchian, MACD, RSI).","upstream_status":"ok"},"meta":{"timestamp":"2026-06-13T04:42:13.524Z","request_id":"4cc356d9-38da-49b3-8137-857128a80423"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":1150,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1650,"monthly_call_quota":57000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":4450,"monthly_call_quota":385000,"rps_limit":16,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":9900,"monthly_call_quota":2350000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/ichimoku-api"}