Yahoo FinanceオプションチェーンAPI

Q: 満期日はどう選びますか？

リクエストでは選べません。この機能が受け付けるのはkeywordのみで、満期日を指定する項目はありません。レスポンスでは利用可能なすべての満期日がexpiration_datesに並び、expirationが返された契約の満期日を示します。異なる日に取得したチェーンを比較する際に揃えられるよう、その日付をすべての行と一緒に保存してください。

Q: 契約が活発に取引されているかはどう判断しますか？

取引高を示すvolumeと、未決済の契約数（建玉）を示すopen_interestを確認し、次にbidとaskの差を見てください。取引高が少なく、建玉が少なく、スプレッドが広い場合、last_priceは古い可能性があり、その価格付近で取引するのは難しいと考えられます。ボラティリティカーブを作成する際は、そうした契約のimplied_volatilityを慎重に扱ってください。

POST

APIの稼働状況

24時間の稼働状況: 正常
24時間の平均応答時間: —

良好／正常
利用可能
制限あり
ほぼ停止

正常

過去24時間

過去30日間

Yahoo Financeの1つのティッカーについてオプションチェーンを取得し、コールとプットごとに権利行使価格、直近価格、買い気配、売り気配、出来高、建玉、インプライド・ボラティリティを確認できます。満期日のパラメータはないため、返された日付はexpiration、満期日の一覧はexpiration_datesで確認してください。

Yahoo Finance Options chainsは、keywordとして渡した1つのティッカーの上場オプションを読み取り、オプションチェーンを1つのオブジェクトとして返します。内容はsymbol、expiration_datesに含まれるすべての満期日、strikesに含まれるすべての権利行使価格、callsとputsの各契約です。各契約について、contract_symbol、strike、last_price、bid、ask、volume、open_interest、implied_volatility、in_the_moneyフラグを取得できます。オプショントレーダー、クオンツリサーチャー、フィンテック開発者は、権利行使価格の一覧確認、インプライド・ボラティリティの追跡、建玉が積み上がる価格帯の把握に利用しています。

ティッカーはAAPLのように、Yahoo Financeでの表記どおりに渡してください。市場サフィックスがある場合はそのまま残します。会社名では検索されません。満期日を選ぶパラメータはないため、expirationで返された契約がどの日付のものかを確認し、expiration_datesを満期日の全一覧として扱ってください。last_priceは直近の約定価格で、取引の少ない契約では古い場合があります。一方、bidとaskは呼び出し時点の市場の気配を示します。

料金は1,000リクエストあたり$1.39（1回あたり$0.001389）です。失敗した呼び出しと空の結果には課金されません。同期処理です。時間のかかるジョブでは、ボディに"mode": "async"を追加し、job_idを取得してポーリングしてください。

AIプロンプト

EveryInfraのYahoo Finance オプションチェーンエンドポイント（yahoo_finance/options）を使ったデータ収集スクリプトの作成を手伝ってください。

エンドポイントの仕組み：
- リクエスト：ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数EVERYINFRA_API_KEYから読み込み、ハードコードしないでください。
- リクエストボディでplatformにyahoo_finance、actionにoptionsを指定し、パラメータはparamsの中に入れます。
- 必須パラメータ：
  - keyword: Yahoo Financeのティッカーシンボルを1つ指定します（例：AAPL）。必要な取引所サフィックスは付けたままにしてください。企業名による全文検索は行いません。history、financials、news、analyst、optionsの各アクションは1リクエストにつき1つのティッカーを処理し、過去の市場データ、財務諸表、ニュース、アナリストカバレッジ、オプションチェーンをそれぞれ取得します。
- 1つのオブジェクトを返します。主なフィールド: contract_symbol、strike、last_price、bid、ask、volume、open_interest、implied_volatility、in_the_money、expiration、symbol、expiration_dates。フィールドは全部で15個です。一覧はhttps://api.everyinfra.com/api/v1/social/catalog?platform=yahoo_financeを参照してください。.
- リクエストボディの例：
{
  "platform": "yahoo_finance",
  "action": "options",
  "params": {
    "keyword": "AAPL"
  }
}
- 料金：1,000リクエストあたり$1.39。失敗時および結果が空の場合は課金されません。
- 対象が数十〜数百件ある場合は、ボディに"mode": "async"を追加します。すぐにjob_idが返されるので、GET https://api.everyinfra.com/api/v1/jobs/{job_id}をポーリングして結果を取得します。
- 422の場合は、エラーに含まれる推奨パラメータ名と指定可能な値を使ってリクエストを修正します。429または503の場合は、Retry-Afterの指定に従って待ってから再試行します。

コードを書く前に、必要な対象とその件数、必要なフィールド、希望する出力形式を私に質問してください。そのうえで、計画と概算費用を私に確認してください。

リクエストパラメータ

名前	場所	型	必須	デフォルト	説明
`Authorization`	header	`string`	はい	-	Bearerの後にAPIキーを続けます。APIキーはコンソールで作成してください。URLやコードリポジトリには絶対に含めないでください。
`platform`	body	`string`	はい	`yahoo_finance`	プラットフォームの識別子です。値は固定です。
`action`	body	`string`	はい	`options`	機能の識別子です。値は固定です。
`keyword`	body.params	`string`	はい	-	Yahoo Financeのティッカーシンボルを1つ指定します（例：AAPL）。必要な取引所サフィックスは付けたままにしてください。企業名による全文検索は行いません。history、financials、news、analyst、optionsの各アクションは1リクエストにつき1つのティッカーを処理し、過去の市場データ、財務諸表、ニュース、アナリストカバレッジ、オプションチェーンをそれぞれ取得します。

コードサンプル

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "yahoo_finance",
  "action": "options",
  "params": {
    "keyword": "AAPL"
  }
}'

OpenAPI定義（JSON）サンプルは環境変数EVERYINFRA_API_KEYからAPIキーを読み込みます。コピーしたコードにAPIキーが含まれることはありません。

レスポンス例

実際のレスポンス

September 26, 2026 at 08:56（UTC）に、上のコードサンプルのパラメータでこのAPIを呼び出して取得しました。resultsとcountはその呼び出しの実際のレスポンスから個人情報（名前、ハンドル、アバター、プロフィールリンク、連絡先）を削除したものです。id、billing、quotaは呼び出しごとに異なるため、構造のみを示しています。

json

{
  "id": "req_…",
  "platform": "yahoo_finance",
  "action": "options",
  "results": {
    "symbol": "AAPL",
    "expiration_dates": [
      "2026-09-28T00:00:00+00:00",
      "2026-09-30T00:00:00+00:00",
      "2026-10-02T00:00:00+00:00"
    ],
    "strikes": [
      250,
      255,
      265
    ],
    "calls": [
      {
        "contract_symbol": "AAPL260928C00250000",
        "strike": 250,
        "last_price": 89.85,
        "bid": 89.25,
        "ask": 92.7,
        "volume": 1,
        "open_interest": 1,
        "implied_volatility": 2.24365673461914,
        "in_the_money": true,
        "expiration": "2026-09-28T00:00:00+00:00"
      },
      {
        "contract_symbol": "AAPL260928C00265000",
        "strike": 265,
        "last_price": 72.52,
        "bid": 74.05,
        "ask": 77.75,
        "volume": 4,
        "open_interest": 5,
        "implied_volatility": 1.9111332568359376,
        "in_the_money": true,
        "expiration": "2026-09-28T00:00:00+00:00"
      },
      {
        "contract_symbol": "AAPL260928C00270000",
        "strike": 270,
        "last_price": 65.74,
        "bid": 69.05,
        "ask": 72.95,
        "volume": 2,
        "open_interest": 3,
        "implied_volatility": 1.84765701171875,
        "in_the_money": true,
        "expiration": "2026-09-28T00:00:00+00:00"
      }
    ],
    "puts": [
      {
        "contract_symbol": "AAPL260928P00250000",
        "strike": 250,
        "last_price": 0.01,
        "bid": 0,
        "ask": 0.01,
        "volume": 7,
        "open_interest": 4,
        "implied_volatility": 1.0625046875000002,
        "in_the_money": false,
        "expiration": "2026-09-28T00:00:00+00:00"
      },
      {
        "contract_symbol": "AAPL260928P00255000",
        "strike": 255,
        "last_price": 0.01,
        "bid": 0,
        "ask": 0.01,
        "volume": 2,
        "open_interest": 4,
        "implied_volatility": 1.000005,
        "in_the_money": false,
        "expiration": "2026-09-28T00:00:00+00:00"
      },
      {
        "contract_symbol": "AAPL260928P00265000",
        "strike": 265,
        "last_price": 0.05,
        "bid": 0,
        "ask": 0.01,
        "volume": 36,
        "open_interest": 12,
        "implied_volatility": 0.87500125,
        "in_the_money": false,
        "expiration": "2026-09-28T00:00:00+00:00"
      }
    ],
    "platform": "yahoo_finance"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

レスポンスフィールド

業務データはresultsに含まれます。この表はレコードに含まれうるフィールドの一覧です。プラットフォームに表示されない値を作り出すことはありません。

フィールド	意味
`contract_symbol`	プラットフォーム上の意味のまま
`strike`	プラットフォーム上の意味のまま
`last_price`	プラットフォーム上の意味のまま
`bid`	プラットフォーム上の意味のまま
`ask`	プラットフォーム上の意味のまま
`volume`	プラットフォーム上の意味のまま
`open_interest`	プラットフォーム上の意味のまま
`implied_volatility`	プラットフォーム上の意味のまま
`in_the_money`	プラットフォーム上の意味のまま
`expiration`	プラットフォーム上の意味のまま
`symbol`	プラットフォーム上の意味のまま
`expiration_dates`	プラットフォーム上の意味のまま
`strikes`	プラットフォーム上の意味のまま
`calls`	プラットフォーム上の意味のまま
`puts`	プラットフォーム上の意味のまま
`platform`	取得元プラットフォームの識別子で、リクエストのplatformと同じです（例：xiaohongshu、tiktok）。

FAQ

満期日はどう選びますか？

リクエストでは選べません。この機能が受け付けるのはkeywordのみで、満期日を指定する項目はありません。レスポンスでは利用可能なすべての満期日がexpiration_datesに並び、expirationが返された契約の満期日を示します。異なる日に取得したチェーンを比較する際に揃えられるよう、その日付をすべての行と一緒に保存してください。

`keyword`には何を指定すればよいですか？

AAPLのように、Yahoo Financeでの表記どおりのティッカーシンボルを1つ指定します。市場サフィックスが付くシンボルは、そのまま残してください。会社名では検索されず、1回の呼び出しで読み取るのは1つのティッカーです。原資産自体の株価情報やファンダメンタルズを確認するには、同じシンボルをYahoo Finance Search機能に渡してください。

契約が活発に取引されているかはどう判断しますか？

取引高を示すvolumeと、未決済の契約数（建玉）を示すopen_interestを確認し、次にbidとaskの差を見てください。取引高が少なく、建玉が少なく、スプレッドが広い場合、last_priceは古い可能性があり、その価格付近で取引するのは難しいと考えられます。ボラティリティカーブを作成する際は、そうした契約のimplied_volatilityを慎重に扱ってください。

エラーと課金

401: キーが未指定か無効です。
402: 残高が不足しています。先にチャージしてください。
422: パラメータ名または値が無効です。エラーに含まれる候補を参考に修正してください。課金はされません。
429: 1分あたりのリクエスト上限に達しました。Retry-Afterの指定に従って待ってから再試行してください。
503: 処理を完了できませんでした。保留中の請求額は残高に戻されます。結果が不明な場合は、再試行する前に確認してください。
200（空）: データがありません。課金はされません。

エラー

公式リファレンス

対象と用語の確認にのみ使用しています。プラットフォームによるEveryInfraの承認や推奨を意味するものではありません。

Yahoo Finance：ティッカーのサフィックス、取引所ごとの遅延、情報の利用 ↗
公式ガイダンスでは、取引所のティッカーサフィックスとデータの遅延は取引所によって異なり、データは情報提供のみを目的とすると定めています。これはティッカーシンボルと市場データの鮮度の範囲を説明するものであり、このエンドポイントがリアルタイム取引に対応していることを裏付けるものではありません。
確認日：2026-09-05