REST · JSON · ключ в заголовке X-API-Key

Данные о курсах в вашу систему

Обменнику — чтобы ставить свой курс от рынка, а не от соседа. Платёжному агенту — чтобы считать себестоимость. Импортёру — чтобы понимать, сколько на самом деле стоит платёж в Китай.

GET/api/v1/rynok/xml?key=rk_…&stat=medianтариф Фид обменника

Для обменников: рыночный курс по 5 000+ направлениям файлом rates.xml — медиана, четверть лучших (p75) или лучший курс конкурентов. В PremiumExchanger: «Парсеры 2.0» → «Добавить сайт» → этот адрес, и курс ставится от рынка формулой.

<rates>
<item><from>USDTTRC20</from><to>SBERRUB</to><in>1</in><out>82.8549</out><amount>3273709877</amount></item>
<item><from>SBERRUB</from><to>USDTTRC20</to><in>88</in><out>1</out><amount>98977566</amount></item>
</rates>

GET/api/v1/rynok?from=SBERRUB&to=USDTTRC20тариф Фид обменника

Мониторинг конкурентов по направлению: рынок и места всех обменников — курс на руки с комиссией, резерв, лимиты, время обновления.

{
  "ok": true,
  "market": { "exchangers": 15, "median": 0.011363636, "p75": 0.011460462, "best": 0.01169659 },
  "competitors": [
    { "place": 1, "exchanger": "Bakster", "rate": 0.01169659, "reserve": 1000000 }
  ]
}

GET/api/v1/rates?asset=USD&city=moscowтариф FREE

Текущий срез всех слоёв: ЦБ, биржа, кассы банков, обменники, P2P, наличные.

{
  "ok": true,
  "asset": "USD",
  "city": "moscow",
  "spread_pct": 3.41,
  "layers": [
    { "layer": "OFFICIAL",  "sell": 80.07, "source": "Банк России" },
    { "layer": "BANK_CASH", "sell": 80.88, "source": "Кассы банков (523 отделения)" },
    { "layer": "CASH_DESK", "sell": 82.81, "sample": 6 }
  ]
}

GET/api/v1/cash?city=dubai&asset=USDтариф PRO

Наличный индекс: медиана, коридор, размер выборки, сколько выбросов отбраковано.

{
  "ok": true,
  "items": [
    {
      "city": "dubai", "asset": "USD",
      "buy": 83.07, "sell": 84.34,
      "corridor": { "low": 83.9, "high": 84.8 },
      "sample": 3, "dropped_outliers": 2, "reliable": true
    }
  ]
}

GET/api/v1/history?asset=USD&kind=cash&city=moscow&limit=500тариф B2B

Исторические ряды по слоям или по наличному индексу — для аналитики и бэктестов.

{
  "ok": true,
  "kind": "cash",
  "points": [
    { "ts": "2026-08-04T06:00:00Z", "buy": 81.4, "sell": 82.6, "sample": 7 }
  ]
}

GET/api/v1/export?kind=cash&city=moscow&days=30тариф PRO

Выгрузка CSV: наличный индекс, слои или сырые котировки. Открывается в Excel без настройки кодировки.

ts;city;asset;buy_median;sell_median;corridor_low;corridor_high;sample;dropped
2026-08-04T12:39:53Z;moscow;USD;81.565;82.805;81.4707;84.1393;6;0

POST/api/v1/routeтариф PRO

Расчёт цепочки: комиссии по шагам, время, результат. Формулу не нужно повторять у себя.

curl -X POST https://realkurs.ru/api/v1/route \
  -H "X-API-Key: rk_..." -H "Content-Type: application/json" \
  -d '{"amount":5000000,"steps":[
    {"title":"нал → USDT","from":"RUB","to":"USDT","rate":0.0121,"feePct":0.5},
    {"title":"USDT → нал","from":"USDT","to":"USD","rate":0.98,"feePct":1}
  ]}'

Виджет для сайта

Бесплатно и без ключа: вставьте iframe — на странице появится живая таблица слоёв со ссылкой на источник. Параметр compact=1 оставит только курс ЦБ и наличные.

<iframe src="https://realkurs.ru/widget/USD?city=moscow"
        width="320" height="260" frameborder="0"
        style="border:0;color-scheme:dark"></iframe>

Что гарантируем

— Свежесть: слои-парсеры обновляются каждые 10–15 минут, наличный индекс — дважды в день.
— Прозрачность: у каждой цифры видно источник, размер выборки и время сбора.
— Честность про возраст: у каждой цифры в ответе есть updated_at и stale. Если данных нет вовсе — null, а не подставленное значение соседнего слоя.
— Приватность источников: точки и контакты не отдаются ни на одном тарифе.

Получить ключ

Тестовый ключ выдаём в тот же день, без договора и предоплаты — посмотрите на данные, потом решайте. Для B2B — договор и закрывающие документы.

Ключ уже есть? Войти в кабинет — лимиты, выгрузки и готовые запросы.