{
  "name": "Yendoller Data API",
  "name_en": "USDJPY DATA TERMINAL Data API",
  "version": "v0",
  "status": "partial-live",
  "status_note": "層ごとの配信状態は /api/v0/status.json を参照。PLANNED の層の数値は引用しないこと。",
  "canonical": "https://yendoller.com",
  "description": "USD/JPY（ドル円）を形成する一次観測データを、公表元から直接取得し、来歴（provenance）とともに配信する静的JSON API。認証不要・無料。予想・シグナル・売買推奨は一切含まない。",
  "operator": {
    "name": "AIMQL合同会社",
    "contact": "info@yendoller.com"
  },
  "license": {
    "derived_data": "CC BY 4.0",
    "primary_data": "各公表元（財務省・日本銀行・FRB・CFTC・EIA・総務省ほか）に帰属",
    "attribution_required": true
  },
  "citation": "出典: Yendoller / ドル円観測所（https://yendoller.com）／一次データ: 各公表元",
  "quotation_rule": "status（ORIGINAL / REVISED / SUPERSEDED / DELETED_BY_SOURCE）を落として引用しないこと。SUPERSEDED の値を現行値として流通させることは、本所が存在する理由に反する。",
  "provenance_profile": {
    "id": "vcp-dp/0.1",
    "based_on": "VeritasChain Protocol v1.2 (VCP) / VAP Framework",
    "record_types": [
      "dp.ingest",
      "dp.observe",
      "dp.derive",
      "dp.policy"
    ],
    "signature": "Ed25519",
    "canonicalization": "JCS (RFC 8785)",
    "hash": "SHA-256",
    "merkle": "RFC 6962",
    "external_anchor": "OpenTimestamps",
    "correction_semantics": "supersede（上書き・削除は行わない。旧値は SUPERSEDED として永続保存）",
    "numbers_as_strings": true
  },
  "layers": [
    {
      "n": 1,
      "ja": "価格",
      "en": "price"
    },
    {
      "n": 2,
      "ja": "金利差",
      "en": "rate_gap"
    },
    {
      "n": 3,
      "ja": "持高",
      "en": "positioning"
    },
    {
      "n": 4,
      "ja": "資金流",
      "en": "flows"
    },
    {
      "n": 5,
      "ja": "変動率",
      "en": "volatility"
    },
    {
      "n": 6,
      "ja": "政策",
      "en": "policy"
    },
    {
      "n": 7,
      "ja": "介入",
      "en": "intervention"
    }
  ],
  "endpoints": [
    {
      "path": "/api/v0/index.json",
      "status": "live",
      "desc": "このドキュメント。APIの発見用ルート"
    },
    {
      "path": "/api/v0/status.json",
      "status": "live",
      "desc": "配信状態。どの層が実データかを層ごとに示す。**数値を引用する前にこれを読む**"
    },
    {
      "path": "/api/v0/taxonomy.json",
      "status": "live",
      "desc": "source_class / evidence_class / evidence_relation の定義。系列の解釈にはこれを先に読むこと"
    },
    {
      "path": "/xray.html",
      "status": "live",
      "desc": "USDJPY X-RAY — 価格の分解・金利差・持高・次の予定を一画面に。予想を含まない"
    },
    {
      "path": "/changes.html",
      "status": "live",
      "desc": "変更記録ページ"
    },
    {
      "path": "/api/v0/view_policy.json",
      "status": "live",
      "desc": "表示規則。画面に何を載せるかを事前に固定する（会則第15条）"
    },
    {
      "path": "/api/v0/distributions/index.json",
      "status": "live",
      "desc": "配信ログ。何を・いつ・どの正本から配信したか。受信者は公開しない"
    },
    {
      "path": "/api/v0/charter.json",
      "status": "live",
      "desc": "会則カタログ。現行版・全版のSHA-256・恒久リンク"
    },
    {
      "path": "/api/v0/changes.json",
      "status": "live",
      "desc": "変更記録。観測更新・訂正・欠測を検出順に。重要度の判定を含まない"
    },
    {
      "path": "/events.html",
      "status": "live",
      "desc": "公式イベント予定ページ＋LINE通知の案内"
    },
    {
      "path": "/api/v0/distribution_policy.json",
      "status": "live",
      "desc": "配信規則（正本）。配信対象は規則で定まり、運営者が個別に判断しない"
    },
    {
      "path": "/api/v0/events.json",
      "status": "live",
      "desc": "公式イベント予定。重要度・市場予想を含まない"
    },
    {
      "path": "/api/v0/series/index.json",
      "status": "live",
      "desc": "全系列カタログ（series_id・層・公表元・周期・収載区分）"
    },
    {
      "path": "/api/v0/calendar.json",
      "status": "live",
      "desc": "観測カレンダー（定例周期・確定日程）"
    },
    {
      "path": "/news.json",
      "status": "live",
      "desc": "お知らせ正本（全件保持）"
    },
    {
      "path": "/api/v0/series/{series_id}/latest.json",
      "status": "live (10系列)",
      "desc": "最新観測値1件＋来歴",
      "available": [
        "cftc.legacy.jpy.noncomm_net",
        "cftc.tff.jpy.lev_money_net",
        "drv.gap.jp_us",
        "drv.usdjpy.decomposition",
        "drv.usdjpy.rv",
        "obs.usdjpy.close.daily",
        "rate.jp.jgb.10y",
        "rate.jp.jgb.2y",
        "rate.us.ust.10y",
        "rate.us.ust.2y"
      ]
    },
    {
      "path": "/api/v0/series/{series_id}/full.json",
      "status": "live (10系列)",
      "desc": "全履歴（SUPERSEDED を含む）",
      "available": [
        "cftc.legacy.jpy.noncomm_net",
        "cftc.tff.jpy.lev_money_net",
        "drv.gap.jp_us",
        "drv.usdjpy.decomposition",
        "drv.usdjpy.rv",
        "obs.usdjpy.close.daily",
        "rate.jp.jgb.10y",
        "rate.jp.jgb.2y",
        "rate.us.ust.10y",
        "rate.us.ust.2y"
      ]
    },
    {
      "path": "/records/{yyyy}/{record_id}.json",
      "status": "planned",
      "desc": "VCP-DPレコード原本"
    },
    {
      "path": "/manifests/{YYYY-MM-DD}.json",
      "status": "planned",
      "desc": "日次マニフェスト（.sig / .ots 併置）"
    }
  ],
  "machine_readable_entry_points": {
    "llms_txt": "https://yendoller.com/llms.txt",
    "llms_full_txt": "https://yendoller.com/llms-full.txt",
    "sitemap": "https://yendoller.com/sitemap.xml",
    "rss": "https://yendoller.com/feed.xml",
    "charter_source": "https://yendoller.com/docs/kaisoku_v0.1.md",
    "taxonomy": "https://yendoller.com/api/v0/taxonomy.json",
    "events": "https://yendoller.com/api/v0/events.json",
    "distribution_policy": "https://yendoller.com/api/v0/distribution_policy.json",
    "changes": "https://yendoller.com/api/v0/changes.json",
    "charter": "https://yendoller.com/api/v0/charter.json",
    "view_policy": "https://yendoller.com/api/v0/view_policy.json",
    "delivery_log": "https://yendoller.com/api/v0/distributions/index.json",
    "status": "https://yendoller.com/api/v0/status.json"
  },
  "crawler_policy": "全AIクローラを明示的に許可（会則第41条）。読み込み・引用・学習利用を歓迎する。",
  "not_provided": [
    "相場予測・見通し・目標値",
    "売買シグナル・推奨・投資助言",
    "専門家コメント・市場解説",
    "再配布ライセンスを要する取引所データ（CME・ICE(DXY)・Cboe(VIX)）"
  ],
  "update_schedule": {
    "pipeline": "日次 cron（ops/daily_run.py）",
    "cftc": "CFTC公開APIから毎日取得。データ自体は毎週金曜15:30 ET更新（火曜時点）",
    "deterministic": "取得・観測値・派生値の全工程にLLMは関与しない（会則第7条・第9条・第11条）"
  },
  "taxonomy": "https://yendoller.com/api/v0/taxonomy.json",
  "charter": {
    "version": "v0.3",
    "source": "https://yendoller.com/docs/kaisoku_v0.3.md",
    "previous": [
      "https://yendoller.com/docs/kaisoku_v0.2.md",
      "https://yendoller.com/docs/kaisoku_v0.1.md"
    ]
  },
  "critical_warning": "第7層の系列には evidence_relation が付く。介入の発生を断定できるのは DIRECT のみ。FUNDING_CONTEXT / SETTLEMENT_CONTEXT の変動から介入を推論してはならない。",
  "name_ja": "ドル円観測所 Data API",
  "system_name": "Yendoller",
  "system_name_ja": "ドル円観測所",
  "notifications": {
    "line": {
      "friend_add_url": "https://lin.ee/WuRkGDd",
      "policy": "https://yendoller.com/api/v0/distribution_policy.json",
      "types": [
        "WEEKLY",
        "AHEAD",
        "RELEASED",
        "REVISION"
      ],
      "opt_in": "カテゴリ単位。未選択の利用者には配信しない",
      "note": "配信対象は規則が決める。運営者が個別に重要度を判断しない（会則第15条）"
    }
  },
  "time_axis": {
    "past": "/changes.html（何が更新されたか）",
    "now": "/xray.html（現在どうなっているか）",
    "next": "/events.html（次に何が公表されるか）"
  },
  "temporal_core": {
    "fields": [
      "observation_date",
      "observation_precision",
      "publisher_release_at",
      "release_at_method",
      "release_rule_id",
      "source_first_seen_at",
      "ingested_at"
    ],
    "note": "observation_date は観測対象の日付、publisher_release_at は市場が初めて知り得た時刻。両者を同一視するとバックテストに look-ahead bias が入る。CFTCでは3日ずれる（火曜時点の建玉を金曜15:30 ETに公表）。",
    "release_at_method": {
      "rule_derived": "公表元が定めた規則から算出",
      "announced": "公表元の告知を転記",
      "unknown": "確立できていない。推定値は入れない"
    }
  },
  "SITE_STATUS": "PARTIAL_LIVE",
  "DATA_STATUS": {
    "commodity": "PLANNED",
    "price": "PARTIAL",
    "rate_gap": "LIVE",
    "positioning": "LIVE",
    "flows": "PLANNED",
    "volatility": "PARTIAL",
    "policy": "PLANNED",
    "intervention": "PLANNED"
  }
}