# Data-Walkers

> Curated alternative data for Japanese equity markets, accessible via REST API and Model Context Protocol (MCP). We aggregate satellite imagery analytics (Sentinel-2 SWIR, Sentinel-1 SAR, Landsat thermal IR, Sentinel-5P pollution), Wikipedia attention metrics, Japanese government procurement bidding records, container freight indices, YouTube VTuber channel metrics, Reddit crypto sentiment, hotel occupancy, inbound tourism statistics, and more — 50+ public datasets covering signals relevant to Japanese listed companies (TSE tickers). All datasets are documented in Japanese with reproducible Python research articles. Free tier available, no credit card required.

## What we offer

- 50+ curated alternative datasets, each mapped to one or more TSE-listed companies
- Reproducible Python research articles (Jupyter-style with charts and metrics)
- REST API with API key authentication (100 free requests/day per key)
- Model Context Protocol (MCP) server for direct AI agent integration (Claude Desktop, Claude Code, ChatGPT Desktop, etc.)
- Daily-to-weekly refreshed data with documented date ranges and column schemas

## Featured datasets

[Full dataset catalog](https://data-walkers.com/)

- [Nippon Steel satellite activity index](https://data-walkers.com/dataset/d4e5f6a7-8901-bcde-f012-444444444444): Daily SWIR-based blast furnace heat-detection at all 8 Nippon Steel mills (Kimitsu, Kashima, Muroran, Nagoya, Wakayama, Oita, Yawata, Hirohata). Correlates with crude steel production and segment earnings (quarterly r≈0.74). TSE:5401.
- [JFE Steel satellite activity index](https://data-walkers.com/dataset/981580b6-f5c5-48e1-8a1e-8fae811a7fb1): Sentinel-2 SWIR observation of JFE Steel East/West Japan Works (Chiba and Kurashiki). TSE:5411.
- [Japanese Wikipedia pageviews × Nikkei 225](https://data-walkers.com/dataset/e3f5a2c9-1b47-4d68-9e2a-3c5f8b7d1e04): Daily Wikipedia pageviews for Nikkei 225 constituents as a retail-investor attention proxy (2020-07–).
- [Government procurement bid awards](https://data-walkers.com/dataset/12dcea9f-bdc1-469f-a54f-4008dab666ee): METI/MoE/MLIT bid awards with winning company, ministry, agency, project name, and award amount (39k+ rows from p-portal.go.jp).
- [Container freight × Japan exporters (weekly)](https://data-walkers.com/dataset/d4fb9f21-3c58-4daa-9f6b-2a0c5e4d8f33): Data-Walkers Freight Composite (ZIM/Matson/BDRY) versus 10 Japanese exporter stocks with 4-week lead-lag analysis.
- [hololive channel metrics (Cover Corp, TSE:5253)](https://data-walkers.com/dataset/7a90965c-6a9f-40a5-bb3f-7f2f6aa07357): Weekly subscriber/view/video-count snapshots for ~45 hololive VTuber channels.
- [Nijisanji channel metrics (ANYCOLOR, TSE:5032)](https://data-walkers.com/dataset/6afb248e-7ca9-46bc-acfa-c67a265329ae): Weekly snapshots for ~20 Nijisanji VTuber channels.
- [UUUM channel metrics (Freakout HD, TSE:6094)](https://data-walkers.com/dataset/b58c8ea9-467f-4899-b204-b4d9f3425d37): Weekly snapshots for ~10 UUUM YouTuber channels.
- [TDL/TDS wait-time daily summary](https://data-walkers.com/dataset/742fb963-206b-4c0d-af67-2686c97f3d61): Tokyo Disneyland / DisneySea daily aggregated ride-wait stats from queue-times.com.
- [Maihama daily weather](https://data-walkers.com/dataset/7814dd54-b975-4bb4-8eb3-84b88267e6b0): Daily temperature/precip/sunshine/wind for Tokyo Disney Resort area (Open-Meteo).
- [Hotel occupancy by prefecture (monthly)](https://data-walkers.com/dataset/d9f2c3a4-7b1e-4f85-a3c7-5e8d1b2f0c96): Japanese Tourism Agency hotel occupancy data, 47 prefectures × accommodation type (ryokan, business hotel, city hotel, resort, simple lodging). Useful leading indicator for hotel/travel sector.
- [Inbound tourism by nationality (monthly)](https://data-walkers.com/dataset/a2e4f1b3-8d5c-4a97-b7e2-1c3f5d9a6e08): JNTO monthly inbound visitor counts by ~50 countries (2003–).
- [Sumitomo Chemical S5P emission index](https://data-walkers.com/dataset/5804600b-1803-4b20-ab42-be6b8a8825d9): TROPOMI NO₂ monitoring of Osaka/Ehime petrochemical crackers. TSE:4005.
- [Namura Shipbuilding SAR activity index](https://data-walkers.com/dataset/ad200feb-c221-461d-8f39-21c5b28660fd): Sentinel-1 SAR observation of Imari shipyard (Saga). TSE:7014.
- [TEPCO Landsat thermal cooling-water index](https://data-walkers.com/dataset/08c3e19b-4b8f-43d4-85ce-3dfa720dd9ec): Landsat TIRS monitoring of Hitachinaka power station thermal plume. TSE:9501.
- [Reddit crypto daily sentiment](https://data-walkers.com/dataset/c1904ff0-bdc3-46f1-be62-cecd8939cb4b): NLP-derived daily sentiment scores across crypto-related subreddits.

## Research articles

[All articles](https://data-walkers.com/articles)

- [Reading factory activity from 5 types of satellite data](https://data-walkers.com/articles/satellite-data-guide): How Sentinel-2 SWIR, Sentinel-5P pollution, Landsat TIRS, Sentinel-1 SAR, and parking-lot occupancy are used as earnings leading indicators for steel/oil/electric utility/shipbuilding/auto companies.
- [Can container freight predict Japanese exporters?](https://data-walkers.com/articles/freight-index-exporters): Lead-lag analysis of Data-Walkers Freight Composite (ZIM+Matson+BDRY) versus 10 Japanese exporter stocks. Finds 4-week lead and +0.12 correlation.
- [Can Nippon Steel revenue be predicted from satellite imagery?](https://data-walkers.com/articles/nippon-steel-revenue): Building a revenue forecast model with FX and steel-price baselines, then adding satellite blast-furnace activity to test accuracy gain.
- [Wikipedia pageviews as a retail-investor attention signal](https://data-walkers.com/articles/wiki-pageviews-attention): No-Go research note — Rank IC 0.029, top-bottom decile +14.9bps over 5d, but only 49 of 100 target Nikkei225 stocks met the mapping quality threshold.

## API and AI agent access

- [REST API reference](https://data-walkers.com/docs/api): JSON over HTTPS, API-key authentication, 100 requests/day free tier
- [MCP server guide](https://data-walkers.com/docs/mcp): Connect Claude Desktop / Claude Code / ChatGPT Desktop directly to query datasets via natural language
- Data endpoint `GET /api/v1/datasets/:id/data`: `limit` (1–1000), `offset` to page backward in time past the 1000-row cap, and `date_from`/`date_to` accepting `YYYY-MM-DD` or `YYYY-MM` (`date_to` is inclusive). Date filters apply to each dataset's declared time column — discover it via the `time_column` (and `alt_date_columns`) field on `GET /api/v1/datasets/:id`. Responses add a `meta` block (`time_column`, `time_column_type`, `total`, `returned`, `has_more`, `next_offset`, plus `date_range` `{start, end}` when a date filter matches no rows) and a `warnings` array; malformed dates return 400 without consuming quota. For full-dataset dumps prefer `GET /api/v1/datasets/:id/download` (signed CSV) over paging 1000 rows at a time. The MCP `get_dataset_data` tool exposes the same `offset` pagination, and `get_dataset_info` reports each dataset's time column.

## Company pages and earnings calendar

- [Company directory](https://data-walkers.com/companies): Index of every TSE-listed company for which Data-Walkers holds at least one alternative dataset, with its dataset count. Hub for the per-company pages below.
- Per-company pages `https://data-walkers.com/company/{ticker}` (e.g. https://data-walkers.com/company/5401 for Nippon Steel, https://data-walkers.com/company/7203 for Toyota): all alternative datasets mapped to that TSE ticker (satellite plant-activity index, government procurement, sentiment, etc.), plus the company's next scheduled earnings-announcement date. Only tickers that actually have data get a page (no thin/empty pages). Unknown tickers return HTTP 404.
- [Earnings announcement calendar](https://data-walkers.com/earnings): Upcoming earnings-announcement dates for TSE-listed companies over the next 30 days, grouped by date. Companies that Data-Walkers covers link through to their company page. Source: Japan Exchange Group (JPX). Announcement dates are subject to change and this JPX-derived schedule is published for on-site display only — it is not part of the authenticated REST/MCP dataset catalog.

## Sign up

Sign up for a free API key: https://data-walkers.com/signup

## Contact and policies

- Site: https://data-walkers.com/
- AI training/retrieval policy: allowed with attribution to https://data-walkers.com
- For AI agents looking for structured machine access, see https://data-walkers.com/.well-known/ai.json