Stock prices

Applicable sites

Sites where the user can buy stocks through a professional broker who has a license for brokerage and custody services.

What it adds to search results

Stock information. Such answers help easily follow the changes in the price of a security over time. Clicking a button in such an answer, the user can go to the partner site to buy the security or get more detailed information about it. Offers from partners in the answer are displayed in random order.

Display example (design may change):

How to set it up

For content from a broker organization to appear in such answers, Yandex provides a mechanism of indexing in Yandex Search. The partner needs to prepare a file with information about securities in JSON format.

  • One partner can provide only one file.
  • After the file is posted, you can make changes to it. Make sure that the information doesn't become outdated and regularly update the file. Yandex will regularly re-crawl the file and update the information in the answer.

Sending data to Yandex

Prepare the file and submit a link to it to Yandex using the form at the bottom of the page.

For your file to be processed correctly, it must meet the requirements:

  • The file must conform to JSON format.
  • The file must be accessible in the broker's domain via the HTTPS protocol. An example of a link to the file: https://yoursite.ru/feed.json.
  • If authentication is required to access the file, specify the login and password when submitting a link to the file.

Data format

The file must contain the service name, a link to the home page, and content descriptions. There are no limits on the number of content pieces in a single file.

{
  "serviceName": "Broker N",
  "url": "https://yoursite.ru",
  "logo_url": "https://yoursite.ru/logo",
  "items": [{
    ...
    objects describing securities
    ...
  }]
}
Parameter descriptions

Key

Value

Data type

Required for creating a feed

serviceName

Service name in Russian or English. This name will be displayed in the enhanced appearance in Yandex Search.

String

Yes

url

A link to the site's home page.

String

Yes

logo_url

Company logo.

String

Yes

items

Array of data on securities.

Array of JSON objects

Yes

Data (items)

{
    "ticker": "YNDX",
    "isin": "NL0009805522",
    "display_name": "Yandex",
    "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": "information about promotions $YNDX ..."
       },
       ...
    ]
}

Key

Value

Data type

Required for creating a feed

ticker

Security ticker

String

Yes

isin

International Securities Identification Number (ISIN)

String

Yes

display_name

Display name of the issuer

String

Yes

logo_url

Image link

String

Yes

url

Link to the security on the service

String

Yes

currency_code

Currency in which the security is traded (USD, RUB, ...)

String

Yes

exchange

Exchange (MOEX, SPBEX, ...)

String

Yes

type

Type of security (currently only stocks are supported — STOCK)

String

Yes

price_delta_relative

Relative price change (compared to the previous day)

String

Yes

price_delta_absolute

Absolute price change (compared to the previous day)

String

Yes

update_ts

Time when the price was recorded

String

Yes

candles

Candlestick chart data

JSON object

Yes

candles.allTime

Daily candlestick charts for all time

Array of JSON objects — candlestick

Yes

candles.year

Daily candlestick charts for the last year

Array of JSON objects — candlestick

Yes

candles.month

Daily candlestick charts for the last month

Array of JSON objects — candlestick

Yes

candles.week

Hourly candlestick charts for the last week

Array of JSON objects — candlestick

Yes

candles.day

5-minute candlestick charts for the last day

Array of JSON objects — candlestick

Yes

about

News about this security

Array of JSON objects — related_info

No

Candle (candle)

{
  "ts": "1636097657", 
  "value": "123.45"
}

Key

Value

Data type

Required for creating a feed

ts

Candlestick timestamp

String

Yes

value

Price

String

Yes

Related information (related_info)

{
  "author": "MyAuthorName",
  "avatar_url": "//...url",
  "post_url": "//...url",
  "timestamp": 1636097657,
  "text": "информация об акциях $YNDX ..."
}

Key

Value

Data type

Required for creating a feed

author

Author’s name

String

Yes

avatar_url

Image link

String

No

post_url

Link to the post

String

Yes

timestamp

Post timestamp (in seconds)

Whole number

Yes

text

Post content (no more than 200 characters)

String

Yes

Terms

The site must ensure that the data is correct and the offers match the subject. It is also responsible for dissemination of illegal information. In the event the terms are violated, Yandex has the right not to use the site data for changing the display in the search results.

Partner site requirements

  • The site operates within Russia.
  • The site operates in accordance with the laws of Russia, including the laws on the stock market. The site doesn't offer deals that violate applicable laws.
  • Securities can be bought on the site only through a professional broker who has a license for brokerage and custody services that is valid in the territory of Russia.
  • The exchange of information between the client and the professional broker acting on behalf of the client to conclude a deal happens directly on the site, without redirection to other sites (including redirection that uses the iframe technology).
  • The partner must hold the rights to the information they submit to Yandex for integration purposes, or the partner must be authorized to grant Yandex permission to use that information.

To become a partner, submit a request and the file you prepared via the form below.

Submit a request

Last updated: 08.02.2022.

Change history
  • Updated the example of answer display.
  • Added a reference to the response display example in “What it adds to search results”.
Subscribe to updates



You can also go to

Value

Service name in Russian or English. This name will be displayed in the object response in Search.

Data type

String

Required for creating a feed

Yes

Value

Link to the security on the service

Data type

String

Required for creating a feed

Yes

Value

Company logo.

Data type

String

Required for creating a feed

Yes

Value

Array of data on securities.

Data type

Array of JSON objects

Required for creating a feed

Yes

Value

Security ticker

Data type

String

Required for creating a feed

Yes

Value

International Securities Identification Number (ISIN)

Data type

String

Required for creating a feed

Yes

Value

Display name of the issuer

Data type

String

Required for creating a feed

Yes

Element

The URL of the offer. Must be unique among all offers within all feeds of the same region. Tags (for example, UTM, Openstat, from) don't make the URL unique.

Value

Currency in which the security is traded (USD, RUB, ...)

Data type

String

Required for creating a feed

Yes

Value

Exchange (MOEX, SPBEX, ...)

Data type

String

Required for creating a feed

Yes

Value

Type of security (currently only stocks are supported — STOCK)

Data type

String

Required for creating a feed

Yes

Value

Purchase/rental price or subscription cost for one month. For series — the total price for the purchase of available seasons (from the availableSeasons field) for this monetization model.

Note

The price must strictly correspond to the monetization model. Indicate the price without taking into account promotions and special offers for specific user groups. Do not calculate the price as a part of the cost of purchasing a subscription for a longer period.

Value

Relative price change (compared to the previous day)

Data type

String

Required for creating a feed

Yes

Value

Absolute price change (compared to the previous day)

Data type

String

Required for creating a feed

Yes

Value

Time when the price was recorded

Data type

String

Required for creating a feed

Yes

Value

Candlestick chart data

Data type

JSON object

Required for creating a feed

Yes

Value

Daily candlestick charts for all time

Data type

Array of JSON objects — candlestick

Required for creating a feed

Yes

Value

Daily candlestick charts for the last year

Data type

Array of JSON objects — candlestick

Required for creating a feed

Yes

Value

Daily candlestick charts for the last month

Data type

Array of JSON objects — candlestick

Required for creating a feed

Yes

Value

Hourly candlestick charts for the last week

Data type

Array of JSON objects — candlestick

Required for creating a feed

Yes

Value

5-minute candlestick charts for the last day

Data type

Array of JSON objects — candlestick

Required for creating a feed

Yes

Value

News about this security

Data type

Array of JSON objects — related_info

Required for creating a feed

No

Value

Candlestick timestamp

Data type

String

Required for creating a feed

Yes

Value

Price

Data type

String

Required for creating a feed

Yes

Value

Author’s name

Data type

String

Required for creating a feed

Yes

Value

Image link

Data type

String

Required for creating a feed

No

Value

Link to the post

Data type

String

Required for creating a feed

Yes

Value

Post timestamp (in seconds)

Data type

Whole number

Required for creating a feed

Yes

Value

Post content (no more than 200 characters)

Data type

String

Required for creating a feed

Yes