Документация API free-rates.ru

Базовый URL

https://free-rates.ru

Все API-эндпоинты возвращают данные в формате JSON.

1. Получить курсы всех активных валютных пар

GET /api/rates

Описание: Возвращает список всех активных валютных пар с текущими курсами, источником данных и временем последнего обновления.

Пример запроса:

curl https://free-rates.ru/api/rates

Пример ответа:


		[
		  {
			"id": 1,
			"from_currency": "BTC",
			"to_currency": "USD",
			"last_value": 71500.25,
			"last_update": "2026-05-04T07:30:00",
			"source_name": "CoinGecko"
		  },
		  {
			"id": 2,
			"from_currency": "ETH",
			"to_currency": "USD",
			"last_value": 2386.08,
			"last_update": "2026-05-04T07:30:00",
			"source_name": "CoinGecko"
		  }
		]

2. Поиск валютной пары

GET /api/search?q={пара}

Описание: Выполняет поиск валютных пар по названию. Можно искать как полное имя пары (например, BTC/USD), так и частичное (например, USD).

Параметр	Тип	Описание
`q`	string	Поисковый запрос (обязательный, не менее 2 символов)

Пример запроса:

curl "https://free-rates.ru/api/search?q=BTC"

Пример ответа:


	        [
		  {
			"id": 1,
			"from_currency": "BTC",
			"to_currency": "USD",
			"last_value": 71500.25,
			"source_name": "CoinGecko"
		  }
		]

Коды ответов:

200 OK — успешный ответ
400 Bad Request — параметр q отсутствует или слишком короткий
500 Internal Server Error — ошибка сервера

Base URL

https://free-rates.ru

All API endpoints return data in JSON format.

1. Get all active currency rates

GET /api/rates

Description: Returns a list of all active currency pairs with current rates, data source, and last update time.

Example request:

curl https://free-rates.ru/api/rates

Example response:


		[
		  {
			"id": 1,
			"from_currency": "BTC",
			"to_currency": "USD",
			"last_value": 71500.25,
			"last_update": "2026-05-04T07:30:00",
			"source_name": "CoinGecko"
		  },
		  {
			"id": 2,
			"from_currency": "ETH",
			"to_currency": "USD",
			"last_value": 2386.08,
			"last_update": "2026-05-04T07:30:00",
			"source_name": "CoinGecko"
		  }
		]

2. Search for a currency pair

GET /api/search?q={pair}

Description: Searches for currency pairs by name. You can search by full pair name (e.g., BTC/USD) or by partial match (e.g., USD).

Parameter	Type	Description
`q`	string	Search query (required, at least 2 characters)

Example request:

curl "https://free-rates.ru/api/search?q=BTC"

Example response:

	     
		[
		  {
			"id": 1,
			"from_currency": "BTC",
			"to_currency": "USD",
			"last_value": 71500.25,
			"source_name": "CoinGecko"
		  }
		]

Response codes:

200 OK — successful response
400 Bad Request — missing or too short query parameter
500 Internal Server Error — server error