Пошук тікерів.

Увага: Усі приклади у документації містять дані, які не несуть реальної інформації!
Ліміт запитів за хвилину: 60
Цей приклад підготовлений з використанням відкритої бібліотеки jQuery
Пошук повертає не більше 30 цінних паперів

Опис даних відповіді з сервера і приклад відповіді

  • /**
 * @typedef {{}} TickerFinderDataRow

* @property {number} instr_id -  унікальний ідентифікатор тікера
* @property {string} nm - Довга назва
* @property {string} n - назва
* @property {string} ln - назва англійською
* @property {string} t - тікер в системі tradernet
* @property {string} isin - isin-код тікера
* @property {number} type - тип інструменту 
* @property {number} kind - підтип інструменту
    type 1 kind 1 - Акції звичайні
    type 1 kind 2 - Акції привілейовані
    type 1 kind 7 - Інвестиційні паї
    type 2 - Облігації
    type 3 - Ф'ючерс
    type 5 - Індекс біржі
    type 6 kind 1 - Гроші
    type 6 kind 8 - Сrypto
    type 8,9,10 - РЕПО
* @property {string} tn - тікер плюс назва
* @property {string} code_nm - тікер на біржі
* @property {number} mkt_id - код ринку
* @property {string} mkt - ринок
 */

/**
 * @typedef {{}} TickerFinderResult
 * @property {TickerFinderDataRow[]} found - масив знайдених тікерів
 */

приклади використання

  • Браузер

    /**
 * @typedef {{
 *  search: string,
 *  q: {
 *      cmd: 'tickerFinder',
 *      params: {
 *          text: string
 *      }
 *  }
 * }} TickerFinderQueryParams
 */

Пошук на вказаній біржі

q:{
    "cmd":"tickerFinder",
    "params":{
        "text": '<ticker>@<market>'
    }
}

де:
    ticker: рядок пошуку {string}
    market:
        'MCX' - ММВБ
        'FORTS' - ММВБ строковий
                'FIX' - NYSE / NASDAQ            
        'UFORTS' - Українська біржа, строковий
        'UFOUND' - Українська біржа
        'EU' - Європа        
        'KASE' - Казахстан
/**
 * @param {string} phrase
 * @param {function} callback
 */
function findTickers(phrase, callback) {
    /**
     * @type {TickerFinderQueryParams}
     */
    var queryParams = {
        q: {
            cmd: 'tickerFinder',
            params: {
                text: phrase.toLowerCase()
            }
        }
    };


    $.getJSON('https://tradernet.com/api', queryParams, callback);
}

findTickers('AAPL.US',

    /**
     * @param {TickerFinderResults} data
     */
    function (data) {
        console.info(data);
    }
);
    online example