Первый вызов в три шага.
Базовый адрес: https://api.satelit.md/v1. HTTPS, JSON, UTF-8. API только для чтения.
-
Выберите тариф и получите ключ
Запросите тариф в панели через аккаунт Satelit. Когда он включён, создайте ключ. Вы видите его один раз. Он выглядит так:
sat_live_…. -
Сделайте вызов
Отправьте ключ в заголовке
Authorization.curl "https://api.satelit.md/v1/rates" \ -H "Authorization: Bearer $SATELIT_KEY"const res = await fetch("https://api.satelit.md/v1/rates", { headers: { Authorization: `Bearer ${process.env.SATELIT_KEY}` }, }); const { data, meta } = await res.json(); console.log(data, meta.credits);import json, os, urllib.request req = urllib.request.Request( "https://api.satelit.md/v1/rates", headers={"Authorization": f"Bearer {os.environ['SATELIT_KEY']}"}, ) with urllib.request.urlopen(req) as res: body = json.load(res) print(body["data"], body["meta"]["credits"])<?php $ch = curl_init("https://api.satelit.md/v1/rates"); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("SATELIT_KEY")], ]); $body = json_decode(curl_exec($ch), true); curl_close($ch); print_r($body["data"]); -
Прочитайте ответ
dataсодержит ответ,metaсодержит кредиты, дату и источники. Заголовки показывают, сколько у вас осталось.{ "data": [ { "code": "EUR", "name": "Евро", "value": 20.0905, "nominal": 1, "date": "2026-11-02", "change_7d_pct": -0.6, "change_30d_pct": -0.1 }, { "code": "USD", "name": "Доллар США", "value": 17.9476, "nominal": 1, "date": "2026-11-02", "change_7d_pct": -0.6, "change_30d_pct": 0.8 }, { "code": "RON", "name": "Румынский лей", "value": 3.7628, "nominal": 1, "date": "2026-11-02", "change_7d_pct": -0.5, "change_30d_pct": -1.2 }, { "code": "UAH", "name": "Украинская гривна", "value": 0.3958, "nominal": 1, "date": "2026-11-02", "change_7d_pct": 0, "change_30d_pct": -0.2 }, { "code": "RUB", "name": "Российский рубль", "value": 0.2228, "nominal": 1, "date": "2026-11-02", "change_7d_pct": -0.5, "change_30d_pct": 4.5 } ], "meta": { "credits": 1, "updated_at": "2026-11-02T13:05:00+02:00", "sources": [ { "name": "BNM", "url": "https://www.bnm.md/ro/official_exchange_rates", "license": "CC BY 4.0" } ], "attribution": "Sursa: Banca Națională a Moldovei, bnm.md, CC BY 4.0", "notice": "Эти же данные бесплатны на bnm.md." } }
Без ключа
GET /v1/sample работает без ключа: курс, предельная цена, новости и дайджест дня. Так вы увидите форму данных до входа.
Соглашения
- Язык:
?lang=ro|ru|en|uk, по умолчаниюro. - Даты:
YYYY-MM-DD. Время в ISO 8601, с часовым поясом. - Деньги: в леях (MDL), числами.
- Методы: GET, HEAD и OPTIONS. API только читает.
- CORS:
*, без cookie. Вы можете вызывать API прямо из браузера, но не кладите платный ключ на публичную страницу.
Обёртка ответа
Все маршруты отвечают одинаково. meta.attribution содержит строку, которую вы показываете на странице, если ваш план требует указывать источник. meta.page есть только в списках.
{
"data": "…",
"meta": {
"credits": 2,
"updated_at": "2026-11-02T13:05:00+02:00",
"sources": [
{
"name": "ANRE",
"url": "https://anre.md/",
"license": "Public data of ANRE"
}
],
"attribution": "Date: Satelit (satelit.md)",
"page": {
"page": 1,
"per": 20,
"total": 240,
"pages": 12
}
}
}Руководства
- АутентификацияКлюч, заголовки и что с ним делает API.
- Кредиты и лимитыКредиты, лимиты в минуту, заголовки, 429.
- ОшибкиКаждый код ошибки и что делать, когда он приходит.
- ВебхукиСобытия, которые приходят к вам, с подписью.
- OAuth и OpenID«Войти через Satelit» на вашем сайте, с PKCE.
- MCP-серверSatelit в ИИ-приложении человека: протокол, OAuth, инструменты.
- Справочник APIВсе маршруты, с параметрами и примерами.