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
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