Перейти к основному содержанию
GET
Символы валют

Начало работы

Базовый URL

Эндпоинт

Эндпоинт symbols — самый простой вызов в сервисе обменных курсов: нужен только API-ключ для получения полного списка доступных символов валют.
Успешный запрос возвращает все доступные символы валют с соответствующими описаниями:

Параметры запроса

api_key
String
обязательно
Ваш уникальный API-ключ. У каждого пользователя уникальные ключи для каждого API Cleariflow, поэтому ключ API обменных курсов не будет работать, например, с API геолокации IP.

Параметры ответа

Ответ API возвращается в универсальном лёгком формате JSON.
currencies
Object
JSON-объект со всеми доступными символами валют как ключами и полными описаниями как значениями. Включает фиатные валюты (USD, EUR, GBP и т.д.) и популярные криптовалюты (BTC, ETH и т.д.).
last_updated
Integer
Unix-метка времени последнего обновления символов валют из источника данных.

Сценарии использования

Получение всех доступных валют

Эндпоинт symbols идеален для:
  • Динамический UI: заполнение выпадающих списков и селекторов валют в приложении
  • Проверка валют: убедиться, что код валюты поддерживается, перед запросами курсов
  • Обзор валют: изучение всех доступных валют в API обменных курсов
  • Настройка приложения: инициализация полным списком поддерживаемых валют

Пример: селектор валют

Поддерживаемые валюты

API обменных курсов поддерживает 80+ валют, включая:
  • Основные фиатные валюты: USD, EUR, GBP, JPY, AUD, CAD, CHF, CNY
  • Европейские валюты: SEK, NOK, DKK, PLN, CZK, HUF, RON, BGN, HRK, ISK
  • Азиатские валюты: KRW, SGD, HKD, TWD, MYR, PHP, THB, IDR, INR, ILS
  • Валюты Америки: BRL, MXN, ARS
  • Африканские валюты: ZAR, MAD, DZD
  • Криптовалюты: BTC, ETH, BNB, DOGE, XRP, BCH, LTC
Все коды валют следуют стандарту ISO 4217 для международной совместимости.