No description, website, or topics provided.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
CS
CS_Advanced
Java
Python
Schemas
API Data Description.pdf
Developer_Manual_NSDData_API.pdf
README.md

README.md

Примеры использования API nsddata.

FAQ чатбот (beta)

Задать роботу вопрос по API

Tutorial

https://github.com/NSDDeveloper/nsddata_api/blob/master/CS_Advanced/README.md

FAQ

Что такое API ключ? Что такое DEMO?

API-ключ это Ваш идентификатор, который Вы дописываете в URL, чтобы сервер понимал кто обратился за данными и выдавал их в соответствии с приобретенным тарифом. В примерах обычно написано &apikey=DEMO, это означает что будет выдан ограниченный десятью записями демонстрационный набор данных. Чтобы получить полный набор данных нужно:

  1. Оформить подписку или пробный доступ (кнопки подписки и тестового доступа размещены на страницах API)
  2. Залогиниться на nsddata.ru
  3. В броузере открыть ссылку https://nsddata.ru/ru/matrix
  4. Переписать себе API ключ и далее подставлять его ко всем запросам вместо &apiKey=DEMO

Как оставить в ответе только несколько полей?

Используйте параметр include. Например, чтобы вывести только ISIN бумаги и название вида бумаги, добавьте названия полей isin и instr_type.name в запрос через запятую после слова include.

https://nsddata.ru/api/get/securities?product=2&include=isin,instr_type.name&apikey=DEMO

Как называются другие поля и что они содержат можно узнать зайдя на страницу https://nsddata.ru/api/ на страницах соответствующих методов.

Как получить только изменившиеся данные за определенный период?

Дата последнего изменения блока содержится в атрибуте "_at".

Пример фильтрации по дате - отображаются все изменения с 1 июня 2018г: https://nsddata.ru/api/get/securities?product=2&filter={"_at":{"$gte":"2018-06-01 00:00:00"}}&apikey=Ваш_API_Ключ

Дата последнего изменения дочерних блоков содержится в атрибуте "_at2".

Как уменьшить объем ответа?

Включите в запрос заголовок: Accept-encoding: gzip

Как отфильтровать не по одному isin, а по двум?

Используйте оператор $in. Пример фильтрация по двум ISIN:

https://nsddata.ru/api/get/securities?product=2&filter={"isin":{"$in":["первый_isin_здесь","второй_isin_здесь"]}}&apikey=Ваш_API_Ключ

Как получить код сектора экономики и другие параметры организации из справочника ЦБ?

Данные находятся в блоке cbr метода getcompanies:

https://nsddata.ru/api/get/companies?limit=1000&product=2&include=cbr&apikey=Ваш_API_Ключ

    "cbr": {
        "inn": "7105008031",
        "kpp": "710501001",
        "ogrn": "1027100507125",
        "name_full": "ПУБЛИЧНОЕ АКЦИОНЕРНОЕ ОБЩЕСТВО \"ТУЛАЧЕРМЕТ\"",
        "address": "300016,ТУЛЬСКАЯ ОБЛ,ТУЛА Г,ПРЖЕВАЛЬСКОГО УЛ,2,",
        "economy_sector": "металлургия",
        "name_short": "ТУЛАЧЕРМЕТ",
        "country": "РОССИЙСКАЯ ФЕДЕРАЦИЯ"
    }

Как получить данные об обращаемости ценной бумаги для льготного налогообложения?

Данные находятся в блоке getsecurities.add_info.marketability

https://nsddata.ru/api/get/securities?product=2&filter={%22add_info.marketability.marketable%22:True}&include=isin,add_info.marketability&apikey=Ваш_API_Ключ

  • add_info.marketability.marketable - была ли сделка за последние 3 месяца
  • add_info.marketability.marketable_date - дата сделки
{
    "isin": "RU000A0JNYN1",
    "add_info": {
        "marketability": {
            "marketable": true,
            "marketable_date": "2018-04-17"
        }
    }
}

Документация разработчика

https://github.com/NSDDeveloper/nsddata_api/blob/master/Developer_Manual_NSDData_API.pdf

Спецификация данных getSecurities, getCompanies, getCorporateActions

https://github.com/NSDDeveloper/nsddata_api/blob/master/API%20Data%20Description.pdf

Примеры на C#

Пример на Java

https://github.com/NSDDeveloper/nsddata_api/tree/master/Java

Пример на Python

https://github.com/NSDDeveloper/nsddata_api/tree/master/Python