Котировки акций

  1. Для каких сайтов
  2. Что добавляет в результаты поиска
  3. Как настроить
  4. Условия

Для каких сайтов

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

Что добавляет в результаты поиска

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

Пример отображения (дизайн может меняться):

Как настроить

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

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

Подготовьте файл и передайте ссылку на него в Яндекс через форму внизу страницы.

Чтобы ваш файл был обработан корректно, он должен соответствовать требованиям:

  • Файл должен соответствовать формату JSON.
  • Файл должен быть доступен по протоколу HTTPS на домене брокера. Пример ссылки на файл: https://yoursite.ru/feed.json.
  • Если для доступа к файлу используется авторизация, укажите логин и пароль при передаче ссылки на файл.
Формат данных

Файл должен содержать название сервиса, ссылку на главную страницу и описание контента. Количество единиц контента в одном файле не ограничено.

{
  "serviceName": "Брокер N",
  "url": "https://yoursite.ru",
  "logo_url": "https://yoursite.ru/logo",
  "items": [{
    ...
    объекты, описывающие ценные бумаги
    ...
  }]
}
Скопировано
Описание параметров
Ключ Значение Тип данных Обязательный при создании
serviceName Название сервиса на русском или английском языке. Это имя будет отображаться в дополненном представлении в Поиске. Строка Да
url Ссылка на главную страницу сайта. Строка Да
logo_url Логотип компании. Строка Да
items Массив данных о ценных бумагах. Массив JSON-объектов Да

Данные (items)

{
    "ticker": "YNDX",
    "isin": "NL0009805522",
    "display_name": "Яндекс",
    "logo_url": "//...url",
    "url": "//...url",
    "currency_code": "RUB",
    "exchange": "MOEX",
    "type": "STOCK",
    "price": "5901.92",
    "price_delta_relative": "-15",
    "price_delta_absolute": "-0.25301",
    "update_ts": "1637068580",
    "candles": {
      "allTime": [{"ts": "", "value": ""}, ....],
      "year": [{"ts": "", "value": ""}, ....],
      "month": [{"ts": "", "value": ""}, ....],
      "week": [{"ts": "", "value": ""}, ....],
      "day": [{"ts": "", "value": ""}, ....],
      },
    "about": [
      {
        "author": "MyAuthorName",
        "avatar_url": "//...url",
        "post_url": "//...url",
        "timestamp": 1636097657,
        "text": "информация об акциях $YNDX ..."
       },
       ...
    ]
}
Скопировано
Ключ Значение Тип данных Обязательный при создании
ticker Тикер ценной бумаги Строка Да
isin Международный идентификатор ценной бумаги (International Securities Identification Number) Строка Да
display_name Отображаемое имя эмитента Строка Да
logo_url Ссылка на картинку Строка Да
url Ссылка на бумагу на сервисе Строка Да
currency_code В какой валюте торгуется бумага (USD, RUB, ...) Строка Да
exchange Биржа (MOEX, SPBEX, ...) Строка Да
type Тип ценной бумаги (сейчас поддерживаются только акции — STOCK) Строка Да
price_delta_relative Изменение цены относительное (относительно прошлого дня) Строка Да
price_delta_absolute Изменение цены абсолютное (относительно прошлого дня) Строка Да
update_ts Время, в которое зафиксирована цена Строка Да
candles Данные о свечах JSON-объект Да
candles.allTime Дневные свечи за все время Массив JSON-объектов — candle Да
candles.year Дневные свечи за последний год Массив JSON-объектов — candle Да
candles.month Дневные свечи за последний месяц Массив JSON-объектов — candle Да
candles.week Часовые свечи за последнюю неделю Массив JSON-объектов — candle Да
candles.day 5-минутные свечи за последний день Массив JSON-объектов — candle Да
about Новости про данную ценную бумагу Массив JSON-объектов — related_info Нет

Свеча (candle)

{
  "ts": "1636097657", 
  "value": "123.45"
}
Скопировано
Ключ Значение Тип данных Обязательный при создании
ts Timestamp свечи Строка Да
value Цена Строка Да

Связанная информация (related_info)

{
  "author": "MyAuthorName",
  "avatar_url": "//...url",
  "post_url": "//...url",
  "timestamp": 1636097657,
  "text": "информация об акциях $YNDX ..."
}
Скопировано
Ключ Значение Тип данных Обязательный при создании
author Имя автора Строка Да
avatar_url Ссылка на картинку Строка Нет
post_url Ссылка на пост Строка Да
timestamp Timestamp поста (в секундах) Целое число Да
text Содержимое поста (не более 200 символов) Строка Да

Условия

Сайт несет ответственность за корректность данных, соответствие предложений тематике, а также за распространение незаконной информации. В случае нарушения условий Яндекс имеет право не использовать данные сайта для изменения представления ответа в поисковой выдаче. См. подробные условия.

Требования к сервису партнера
  • Сервис действует на территории Российской Федерации.
  • Сервис действует в соответствии с законодательством Российской Федерации, в том числе законодательством о рынке ценных бумаг. На сервисе не предлагается совершение сделок, не соответствующих действующему законодательству.
  • На сервисе можно приобретать ценные бумаги только через профессионального участника рынка ценных бумаг, который имеет лицензию на брокерское и депозитарное обслуживание, действующую на территории Российской Федерации.
  • Обмен информацией между клиентом и профессиональным участником рынка ценных бумаг, выполняющим распоряжение клиента на совершение сделки, осуществляется непосредственно на сервисе, без переадресации на другие сервисы (в т. ч. по технологии iframe).
  • Партнер должен являться правообладателем информации, передаваемой в рамках интеграции Яндексу, либо обладать необходимыми полномочиями для использования указанной информации Яндексом.

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

Дата обновления страницы: 08.02.2022.

Предыдущие версии документа

История изменений
  • Обновлен пример отображения ответа.
  • Добавлено упоминание о примере отображения ответа в разделе «Что добавляет в результаты поиска».