Nikkei Fear & Greed Index API

Base URL

All endpoints are accessed via a single base URL with an ?action= query parameter:

https://nikkei.feargreedchart.com/api/?action=<endpoint>

All responses are JSON. CORS is open (Access-Control-Allow-Origin: *) so you can call this directly from a browser.

Live Score

{
  "score": 63,
  "label": "Greed",
  "updated_at": "2026-05-16T04:00:21+00:00",
  "nikkei": {
    "level": 61409.29,
    "level_date": "2026-05-15",
    "change_pct": -1.99
  },
  "usdjpy": {
    "rate": 156.64,
    "rate_date": "2026-05-15"
  },
  "components": {
    "momentum": {
      "score": 83,
      "ratio": 1.135,
      "label": "Stretched"
    },
    "volatility": {
      "score": 49,
      "vol": 0.131,
      "label": "Choppy"
    },
    "currency": {
      "score": 22,
      "chg_20d": -1.62,
      "label": "Yen firming"
    },
    "foreign_flow": {
      "score": 96,
      "value_kyen": 1209653731,
      "net_weekly_b_yen": 1209.65,
      "week_end": "2026-05-08",
      "sample_size": 104
    }
  },
  "ff_status": "live",
  "source_notes": "Nikkei 225 © Nikkei Inc. via FRED. USD/JPY via FRED. Foreign flow from JPX Trading by Type of Investors (weekly)."
}

Yen & Rates

Historical Scores

{
  "date": "2026-05-15",
  "score": 63,
  "label": "Greed",
  "m": 83,
  "v": 49,
  "c": 22,
  "f": 96,
  "f_week_end": "2026-05-08",
  "nikkei": 61409.29,
  "fx": 156.64
}

Foreign Investor Flow

Health Check

{
  "status": "ok",
  "time": "2026-05-16T04:00:21+00:00",
  "data_dir_writable": true,
  "history_file_exists": true,
  "flow_file_exists": true
}

Code examples

JavaScript (fetch)

// Get today's Nikkei F&G score
fetch('https://nikkei.feargreedchart.com/api/?action=nikkei')
  .then(r => r.json())
  .then(data => {
    console.log('Score:', data.score, '(' + data.label + ')');
    console.log('Nikkei 225:', data.nikkei.level);
    console.log('USD/JPY:', data.usdjpy.rate);

    // Component breakdown
    const c = data.components;
    console.log('Momentum:', c.momentum.score);
    console.log('Volatility:', c.volatility.score);
    console.log('Currency:', c.currency.score);
    if (c.foreign_flow) {
      console.log('Foreign flow:', c.foreign_flow.score,
                  '(¥' + c.foreign_flow.net_weekly_b_yen + 'B)');
    }
  });

Python (requests)

import requests

r = requests.get("https://nikkei.feargreedchart.com/api/?action=nikkei")
data = r.json()

print(f"Score: {data['score']} ({data['label']})")
print(f"Nikkei 225: {data['nikkei']['level']:,.2f}")
print(f"USD/JPY:   {data['usdjpy']['rate']:.2f}")

# Component breakdown
for name, c in data["components"].items():
    if c is not None:
        print(f"  {name:14s} {c['score']:3d}")

cURL

curl -s "https://nikkei.feargreedchart.com/api/?action=nikkei" | jq .score
# 63

curl -s "https://nikkei.feargreedchart.com/api/?action=nikkei-history" | jq '.count'
# 1553

Caching & rate limits

• No published rate limit — please be reasonable. The data refreshes once per day after Tokyo close (15:00 JST), so polling more often than every few minutes is wasteful.
• Server-side cache: ?action=nikkei is cached for 5 minutes. ?action=nikkei-rates and ?action=nikkei-history are cached for 1 hour. ?action=nikkei-flow serves the static flow file directly.
• Schedule: Daily score refresh runs at 07:45 UTC Mon–Fri (16:45 JST, after Tokyo close). Weekly foreign flow refresh runs at 08:00 UTC every Thursday (17:00 JST, after JPX publishes).
• CORS: Open for all origins. Fetch directly from a browser, a static site, or a serverless function.

Attribution & terms

The API and methodology are free to use. If you build something public with this data, a link back to Nikkei.FearGreedChart.com is appreciated but not required.

Underlying data: Nikkei 225 © Nikkei Inc. (via FRED). USD/JPY via FRED DEXJPUS. JGB 10Y via FRED/OECD. Foreign investor flow from JPX Trading by Type of Investors (weekly XLS, public).

Data is provided as-is with no uptime guarantee. Nothing here is investment advice. Always consult a qualified financial professional before making investment decisions.