Exchange rates

The rate of the day

GET/v1/rates

All 5 currencies, with the change over 7 and 30 days.

Credits: 1
: With a key

Parameters

No parameters.

Possible errors

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"]);

Response

{
  "data": [
    {
      "code": "EUR",
      "name": "Euro",
      "value": 20.0905,
      "nominal": 1,
      "date": "2026-11-02",
      "change_7d_pct": -0.6,
      "change_30d_pct": -0.1
    },
    {
      "code": "USD",
      "name": "US dollar",
      "value": 17.9476,
      "nominal": 1,
      "date": "2026-11-02",
      "change_7d_pct": -0.6,
      "change_30d_pct": 0.8
    },
    {
      "code": "RON",
      "name": "Romanian leu",
      "value": 3.7628,
      "nominal": 1,
      "date": "2026-11-02",
      "change_7d_pct": -0.5,
      "change_30d_pct": -1.2
    },
    {
      "code": "UAH",
      "name": "Ukrainian hryvnia",
      "value": 0.3958,
      "nominal": 1,
      "date": "2026-11-02",
      "change_7d_pct": 0,
      "change_30d_pct": -0.2
    },
    {
      "code": "RUB",
      "name": "Russian ruble",
      "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": "The same data is free at bnm.md."
  }
}

A currency's history

GET/v1/rates/history

A currency's daily values. Costs 1 credit for every 30 days or part of them.

Credits: 1 for every 30 days, rounded up
: With a key

Parameters

codestringrequired

The currency or airport code.
daysintegeroptionaldefault 30

How many days back. Cut at the plan's limit.

Possible errors

Try it

curl "https://api.satelit.md/v1/rates/history?code=EUR&days=30" \
  -H "Authorization: Bearer $SATELIT_KEY"

const res = await fetch("https://api.satelit.md/v1/rates/history?code=EUR&days=30", {
  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/history?code=EUR&days=30",
    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/history?code=EUR&days=30");
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"]);

Response

{
  "data": {
    "code": "EUR",
    "points": [
      {
        "date": "2026-11-01",
        "value": 20.0954
      },
      {
        "date": "2026-11-02",
        "value": 20.0905
      },
      {
        "date": "2026-11-03",
        "value": 20.0905
      }
    ]
  },
  "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": "The same data is free at bnm.md."
  }
}