API документация

Мы предоставляем простой REST API способ получать курсы валют по отношению к кыргызскому сому. API располагает несколькими эндпоинтами, которые предназначены для разных сценариев использования курсов валют.

Определения

Объект Описание
API токен Уникальных ключ, который используется для идентификации пользователя API через Bearer Token Authorization Header.
Код валюты Трехсимвольный ISO код валюты.
Базовая валюта Валюта, по отношению к которой возвращается курс. Пример: 1 доллар = 88 сомов, сом будет являться Базовой валютой.

Авторизация и API токен

Вам необходимо зарегистрироваться и получить API Bearer Token. Затем вы должны отправлять его с каждым запросом к нашему API.

Базовый API URL:

https://data.fx.kg/api/v1/

Пример API Bearer Token:

L5HoneK2u1F61cYy6IX6SLv7BkaYKVB2iZzfVBa9

Вы можете получить больше информации о том, как использовать токен по этой ссылке.

Real-time курсы

Курсы валют в режиме реального времени.

Средние курсы валют

https://data.fx.kg/api/v1/average
Response:
{
    "updated_at": null,
    "type": null,
    "buy_usd": "87.00",
    "sell_usd": "87.70",
    "buy_eur": "96.30",
    "sell_eur": "97.30",
    "buy_rub": "1.10",
    "sell_rub": "1.12",
    "buy_kzt": "0.14",
    "sell_kzt": "0.20"
}
            

Лучшие курсы валют

https://data.fx.kg/api/v1/best
Response:
{
    "updated_at": null,
    "type": null,
    "buy_usd": "87.00",
    "sell_usd": "87.70",
    "buy_eur": "96.30",
    "sell_eur": "97.30",
    "buy_rub": "1.10",
    "sell_rub": "1.12",
    "buy_kzt": "0.14",
    "sell_kzt": "0.20"
}
            

Текущие курсы коммерческих банков

https://data.fx.kg/api/v1/current
Response:
[
    {
        "id": 1,
        "title": "РСК Банк",
        "official_title": "ОАО \"РСК Банк\"",
        "slug": "rsk-bank",
        "website_url": "http://www.rsk.kg",
        "rates": [
            {
                "organization_id": 1,
                "base_currency_id": 1,
                "created_at": "2023-06-15T02:35:05.000000Z",
                "updated_at": "2023-06-15T02:35:05.000000Z",
                "is_current": 1,
                "type": "cashless",
                "buy_usd": "87.00",
                "sell_usd": "87.64",
                "buy_eur": "94.50",
                "sell_eur": "95.50",
                "buy_rub": "1.020",
                "sell_rub": "1.070",
                "buy_kzt": "0.130",
                "sell_kzt": "0.200",
                "buy_uzs": null,
                "sell_uzs": null,
                "buy_cny": "11.00",
                "sell_cny": "14.00",
                "buy_gbp": null,
                "sell_gbp": null,
                "buy_try": null,
                "sell_try": null
            },
            {
                "organization_id": 1,
                "base_currency_id": 1,
                "created_at": "2023-06-15T02:40:04.000000Z",
                "updated_at": "2023-06-15T02:40:04.000000Z",
                "is_current": 1,
                "type": "regular",
                "buy_usd": "87.40",
                "sell_usd": "88.10",
                "buy_eur": "94.50",
                "sell_eur": "95.50",
                "buy_rub": "1.030",
                "sell_rub": "1.060",
                "buy_kzt": "0.130",
                "sell_kzt": "0.200",
                "buy_uzs": null,
                "sell_uzs": null,
                "buy_cny": null,
                "sell_cny": null,
                "buy_gbp": null,
                "sell_gbp": null,
                "buy_try": null,
                "sell_try": null
            }
        ]
    },
    {
        "id": 2,
        "title": "Оптима Банк",
        "official_title": "ОАО \"Оптима Банк\"",
        "slug": "optima-bank",
        "website_url": "https://www.optimabank.kg",
        "rates": [
            {
                "organization_id": 2,
                "base_currency_id": 1,
                "created_at": "2023-06-15T03:05:31.000000Z",
                "updated_at": "2023-06-15T03:05:31.000000Z",
                "is_current": 1,
                "type": "regular",
                "buy_usd": "87.50",
                "sell_usd": "88.00",
                "buy_eur": "94.40",
                "sell_eur": "95.40",
                "buy_rub": "1.030",
                "sell_rub": "1.055",
                "buy_kzt": "0.135",
                "sell_kzt": "0.205",
                "buy_uzs": null,
                "sell_uzs": null,
                "buy_cny": null,
                "sell_cny": null,
                "buy_gbp": null,
                "sell_gbp": null,
                "buy_try": null,
                "sell_try": null
            },
            {
                "organization_id": 2,
                "base_currency_id": 1,
                "created_at": "2023-06-15T03:05:31.000000Z",
                "updated_at": "2023-06-15T03:05:31.000000Z",
                "is_current": 1,
                "type": "cashless",
                "buy_usd": "87.30",
                "sell_usd": "87.64",
                "buy_eur": "94.40",
                "sell_eur": "95.40",
                "buy_rub": "1.010",
                "sell_rub": "1.080",
                "buy_kzt": "0.135",
                "sell_kzt": "0.205",
                "buy_uzs": null,
                "sell_uzs": null,
                "buy_cny": null,
                "sell_cny": null,
                "buy_gbp": null,
                "sell_gbp": null,
                "buy_try": null,
                "sell_try": null
            }
        ]
    },
    {...}
]
            

Текущие курсы Национального Банка

https://data.fx.kg/api/v1/central
Response:
{
    "created_at": "2023-06-26T10:00:34.000000Z",
    "updated_at": "2023-06-26T10:00:34.000000Z",
    "is_current": 1,
    "usd": "87.3231",
    "eur": "95.1036",
    "kzt": "0.1940",
    "rub": "1.0323",
    "gbp": "110.8733",
    "dkk": "12.7144",
    "inr": "1.0641",
    "cad": "66.1026",
    "cny": "12.1595",
    "krw": "0.0666",
    "nok": "8.0359",
    "xdr": "117.0534",
    "sek": "8.0974",
    "chf": "96.9444",
    "jpy": "6.1007",
    "amd": "2.2608",
    "byr": "0.3402",
    "mdl": "4.8381",
    "tjs": "7.9993",
    "uzs": "0.0076",
    "uah": "2.3873",
    "kwd": "283.8142",
    "huf": "2.5562",
    "czk": "3.9963",
    "nzd": "53.5139",
    "pkr": "0.3047",
    "aud": "58.3895",
    "try": "3.4586",
    "azn": "51.3520",
    "sgd": "64.5340",
    "afn": "1.0170",
    "bgn": "48.4238",
    "brl": "18.2885",
    "gel": "33.2439",
    "aed": "23.7673",
    "irr": "0.0208",
    "myr": "18.6675",
    "mnt": "0.0253",
    "twd": "2.8099",
    "tmt": "24.9424",
    "pln": "21.3464",
    "sar": "23.2718",
    "byn": "29.2948"
}
            

Архив курсов

Мы располагаем архивом изменения курсов валют с 2013 года. Ведется работа по предоставлению архивных данных по курсам валют.

Общие данные

Дополнительные эндпоинты, которые могут быть полезны.

Список доступных валют

https://data.fx.kg/api/v1/currencies
Response:
[
    {
        "id": 1,
        "code": "KGS",
        "title": "Кыргызский сом"
    },
    {
        "id": 2,
        "code": "USD",
        "title": "Доллар США"
    },
    {
        "id": 3,
        "code": "EUR",
        "title": "Евро"
    },
    {
        "id": 4,
        "code": "RUB",
        "title": "Российский рубль"
    },
    {
        "id": 5,
        "code": "KZT",
        "title": "Казахский тенге"
    },
    {...}
]
            
Response объекты:
Объект Описание
id Внутренний ID валюты.
code Трехсимвольный ISO код валюты.
title Название валюты на русском языке.

Список свободно конвертируемых валют

https://data.fx.kg/api/v1/currencies/convertible
            
Response:
[
    {
        "id": 2,
        "code": "USD",
        "title": "Доллар США"
    },
    {
        "id": 3,
        "code": "EUR",
        "title": "Евро"
    },
    {
        "id": 4,
        "code": "RUB",
        "title": "Российский рубль"
    },
    {
        "id": 5,
        "code": "KZT",
        "title": "Казахский тенге"
    }
]
            
Response объекты:
Объект Описание
id Внутренний ID валюты.
code Трехсимвольный ISO код валюты.
title Название валюты на русском языке.