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

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

$responseExample = [
    'found' => [
        [0] => [
            "instr_id":"1005554",
             "nm":"Apple inc.",
             "n":"Apple inc.",
             "ln":"Apple",
             "t":"AAPL.US",
             "isin":"US0000001",
             "type":1,
             "kind":1,
             "tn":"Apple inc.",
             "code_nm":"AAPL.US",
             "mkt_id":"900000001",
             "mkt":"FIX"
        ]
    ]
    'code' => 0
]

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

  • Браузер

    /**
 * @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

  • PHP

    /**

* @param {string} text - Рядок пошуку
    text = '<ticker>
    text = '<ticker>@<market>'
*/

де:
ticker: рядок пошуку {string}
market:
    'MCX' - ММВБ
    'FORTS' - ММВБ строковий
    'FIX' - NYSE / NASDAQ
    'UFORTS' - Українська біржа, строковий
    'UFOUND' - Українська біржа
    'EU' - Європа

    'KASE' - Казахстан


$publicApiClient = new PublicApiClient($apiKey, $apiSecretKey, Nt\PublicApiClient::V1);

$responseExample = $publicApiClient->sendRequest('tickerFinder', ['text'=> 'AAPL.US'], 'array');