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

Увага: Усі приклади у документації містять дані, які не несуть реальної інформації!
Ліміт запитів за хвилину: 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