API Yahoo Finance Цепочки опционов

Q: Как выбрать дату экспирации?

В запросе её выбрать нельзя: возможность принимает только keyword, без параметра выбора экспирации. Ответ содержит все доступные экспирации в expiration_dates, а expiration показывает, к какой дате относятся полученные контракты. Сохраняйте эту дату в каждой записи, чтобы цепочки, полученные в разные дни, можно было правильно сопоставить.

Q: Как понять, активно ли торгуется контракт?

Смотрите на volume, объём торгов, и open_interest, число открытых контрактов, а затем на разницу между bid и ask. Малый объём, низкий открытый интерес и широкий спред означают, что last_price может быть устаревшей, а совершить сделку по цене, близкой к ней, будет трудно. С осторожностью используйте implied_volatility таких контрактов при построении кривой волатильности.

POST

Состояние API

Состояние за 24 ч: Норма
Среднее время за 24 ч: —

Стабильно / норма
Доступно
Ограничено
Почти недоступно

Норма

Последние 24 часа

Последние 30 дней

Изучите опционную цепочку по одному тикеру Yahoo Finance: коллы и путы со страйком, последней ценой, bid, ask, объёмом, открытым интересом и подразумеваемой волатильностью. Параметра для даты экспирации нет, поэтому возвращённую дату смотрите в expiration, а полный список дат — в expiration_dates.

Yahoo Finance Options chains читает торгуемые опционы по одному тикеру, переданному в keyword, и возвращает цепочку одним объектом: symbol, все даты экспирации в expiration_dates, все страйки в strikes и контракты в calls и puts. По каждому контракту вы получаете contract_symbol, strike, last_price, bid, ask, volume, open_interest, implied_volatility и флаг in_the_money. Опционные трейдеры, количественные аналитики и разработчики финтех-продуктов используют её, чтобы просматривать страйки, следить за подразумеваемой волатильностью и видеть, где накапливается открытый интерес.

Передавайте тикер ровно так, как его пишет Yahoo Finance, например AAPL, сохраняя суффикс рынка, если он есть; поиск по названию компании не выполняется. Параметра для выбора экспирации нет, поэтому смотрите expiration, чтобы знать, к какой дате относятся полученные контракты, а expiration_dates считайте полным календарём. last_price — цена последней сделки, которая у малоактивного контракта может быть давней, а bid и ask показывают состояние рынка на момент вызова.

Цена: $1.39 за 1 000 запросов ($0.001389 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Yahoo Finance Цепочки опционов (yahoo_finance/options).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: yahoo_finance и action: options, а параметры передайте в params.
- Обязательные параметры:
  - keyword: Один тикер Yahoo Finance (например, AAPL) с сохранением обязательных суффиксов биржи. Полнотекстовый поиск по названию компании не выполняется.
- Возвращает один объект. Основные поля: 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.39 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.

Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.

Параметры запроса

Имя	Расположение	Тип	Обязательный	По умолчанию	Описание
`Authorization`	header	`string`	Да	-	Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
`platform`	body	`string`	Да	`yahoo_finance`	Идентификатор платформы, фиксированное значение.
`action`	body	`string`	Да	`options`	Идентификатор возможности, фиксированное значение.
`keyword`	body.params	`string`	Да	-	Один тикер Yahoo Finance (например, AAPL) с сохранением обязательных суффиксов биржи. Полнотекстовый поиск по названию компании не выполняется. Действия history, financials, news, analyst и options обрабатывают один тикер за запрос и возвращают исторические рыночные данные, финансовую отчётность, новости, данные аналитиков или цепочки опционов.

Примеры кода

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; скопированный код никогда не содержит ваш ключ.

Пример ответа

Реальный ответ

Получено 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`?

Один тикер ровно в том виде, как он указан на Yahoo Finance, например AAPL, с суффиксом рынка, если он есть. Поиск по названиям компаний не выполняется, и каждый вызов читает один тикер. Чтобы получить котировку и фундаментальные показатели базового актива, передайте тот же тикер в возможность Yahoo Finance Search.

Как понять, активно ли торгуется контракт?

Смотрите на volume, объём торгов, и open_interest, число открытых контрактов, а затем на разницу между bid и ask. Малый объём, низкий открытый интерес и широкий спред означают, что last_price может быть устаревшей, а совершить сделку по цене, близкой к ней, будет трудно. С осторожностью используйте implied_volatility таких контрактов при построении кривой волатильности.

Ошибки и оплата

401: Ключ отсутствует или недействителен.
402: Недостаточно средств на балансе. Сначала пополните баланс.
422: Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429: Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503: Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто): Нет данных. Без списания.

Ошибки

Официальные источники

Используются только для проверки объектов и терминов. Они не означают, что платформа разрешила или одобрила работу EveryInfra.

Yahoo Finance: суффиксы тикеров, задержки данных на биржах и использование информации ↗
Официальные пояснения указывают, что суффиксы тикеров и задержки данных различаются по биржам, а данные предоставляются исключительно в информационных целях. Это поясняет ограничения, связанные с символами тикеров и актуальностью рыночных данных, но не подтверждает, что этот эндпоинт поддерживает торговлю в реальном времени.
Проверено 2026-09-05