Data-Walkers REST API リファレンス

REST APIでオルタナティブデータにプログラムからアクセスできます。検索系(一覧・検索・カテゴリ)はAPIキー不要。データ本体の取得とダウンロードには認証が必要です。

認証

ヘッダー X-API-Key: dw_xxxxxxxx または Authorization: Bearer YOUR_API_KEY。
APIキーは無料の会員登録後、 https://data-walkers.com/settings で発行。
無料枠は100リクエスト/日(APIキーごと、UTC 00:00リセット)。残量はレスポンスヘッダー X-RateLimit-Remaining で確認。

エンドポイント(ベース: https://data-walkers.com/api/v1 )

GET /api/v1/datasets — データセット一覧・絞り込み(category, ticker, q)。認証不要。
GET /api/v1/datasets/:id — 単一データセット(メタデータ+プレビュー)。日付フィルター対象の時系列カラム名 time_column と代替日付カラム alt_date_columns も返す。認証不要。
GET /api/v1/datasets/:id/data — 実データ行を取得(limit, offset, date_from, date_to)。要APIキー。パラメータ詳細は下記。
GET /api/v1/datasets/:id/download — 署名付きCSVダウンロードURL(1時間有効)。要APIキー。
GET /api/v1/tickers/:ticker — 証券コード(TSE 4桁)に紐づくデータセット一覧。認証不要。
GET /api/v1/search — 全文検索。認証不要。
GET /api/v1/categories — カテゴリ名一覧。認証不要。

データ取得(/datasets/:id/data)のパラメータとレスポンス

limit — 取得行数(1〜1000、既定200)。
offset — 時系列をさかのぼって次ページを取得(0が最新のwindow)。1000行を超えるデータセットを分割取得する際に使用。
date_from / date_to — 期間フィルター。YYYY-MM-DD または YYYY-MM 形式。date_to は指定した日/月を含む(inclusive)。フィルターは各データセットが宣言する時系列カラムに適用され、そのカラム名は GET /api/v1/datasets/:id の time_column で確認できる。

レスポンスは行データに加えて meta(time_column, time_column_type, total, returned, has_more, next_offset、該当時は date_range)と、未知パラメータを通知する warnings 配列を含む。日付形式が不正な場合は 400 を返し、クォータは消費されない。

大量取得の注意: 無料枠は100リクエスト/日、1リクエスト最大1000行。データセット全体をまとめて取得したい場合は offset で1000行ずつ辿るより GET /api/v1/datasets/:id/download の署名付きCSVを利用すること。

例

# 認証不要
curl "https://data-walkers.com/api/v1/tickers/5401"
# データ取得(要APIキー)
curl "https://data-walkers.com/api/v1/datasets/<UUID>/data?limit=100" -H "X-API-Key: dw_xxxxxxxxxxxxxxxx"
# 1000行超をページング(古い方向へ)・期間指定(月指定も可)
curl "https://data-walkers.com/api/v1/datasets/<UUID>/data?limit=1000&offset=1000&date_from=2025-01&date_to=2025-06" -H "X-API-Key: dw_xxxxxxxxxxxxxxxx"

ステータスコード

400 日付パラメータの形式不正(クォータ消費なし) / 401 APIキーが欠落・無効 / 404 データセットが存在しない / 429 日次上限超過 / 500 サーバーエラー

Claude等のAIエージェントから自然言語で使う場合はMCP接続が便利です: https://data-walkers.com/docs/mcp