CurrencyRateAPI

Εργαλείο γρήγορης εκκίνησης

Χρειάζεται να δοκιμάσετε το API χωρίς να ψάξετε σε όλη την τεκμηρίωση; Μεταβείτε στον Πίνακα Ελέγχου, όπου θα βρείτε το Εργαλείο Γρήγορης Εκκίνησης — έναν απλό τρόπο για να δοκιμάσετε όλα τα διαθέσιμα τελικά σημεία με ένα μόνο κλικ.

Κάντε κλικ στο παρακάτω κουμπί για να εγγραφείτε δωρεάν και να ξεκινήσετε να χρησιμοποιείτε το Εργαλείο γρήγορης εκκίνησης.

Ξεκινώντας

Βασικοί όροι και έννοιες που θα χρειαστείτε για να ξεκινήσετε να εργάζεστε με το Currency Rate API:

Απόκριση API

Οι συναλλαγματικές ισοτιμίες που παρέχονται από το CurrencyRateAPI είναι από προεπιλογή σε ευρώ. Όλα τα δεδομένα επιστρέφονται σε τυπική μορφή JSON και μπορούν εύκολα να αναλυθούν χρησιμοποιώντας οποιαδήποτε γλώσσα προγραμματισμού.

Δείγμα απάντησης:
Παρακάτω θα βρείτε ένα δείγμα απόκρισης API που περιέχει μια σειρά από κοινά παγκόσμια νομίσματα, όλα σε σχέση με το νόμισμα EUR και με μια χρονική σήμανση στην οποία ελήφθησαν.

{
    "success": true,
    "base": "eur",
    "date": "2025-08-25",
    "rates": {
        "usd": "1.1697",
        "gbp": "0.8659",
        "cad": "1.6171"
    },
    "last_update_unix": "1769067006"
}

Όπως φαίνεται παραπάνω, η απόκριση API για τις συναλλαγματικές ισοτιμίες σε πραγματικό χρόνο περιλαμβάνει πολλά βασικά πεδία:

• success υποδεικνύει εάν το αίτημα ήταν επιτυχές.
• base επιστρέφει τον κωδικό 3 γραμμάτων του βασικού νομίσματος που χρησιμοποιείται για αυτό το αίτημα.
• date επιστρέφει την πραγματική ημερομηνία για την οποία παρέχονται οι συναλλαγματικές ισοτιμίες (μορφή ΕΕΕΕ-ΜΜ-ΗΗ).
• rates περιέχει τη λίστα των ζητούμενων νομισμάτων και τις τρέχουσες συναλλαγματικές τους ισοτιμίες.
• last_update_unix Εμφανίζει τη χρονική σήμανση (σε μορφή Unix) των πιο πρόσφατων διαθέσιμων δεδομένων στο σύστημα.

Διαθέσιμα Τελικά Σημεία

Το CurrencyRateAPI περιλαμβάνει πολλά τελικά σημεία API, καθένα από τα οποία προσφέρει συγκεκριμένη λειτουργικότητα. Η διαθεσιμότητα ορισμένων τελικών σημείων εξαρτάται από το πρόγραμμα συνδρομής σας.

• Τελικό σημείο της λίστας νομισμάτων. Αυτό το τελικό σημείο επιστρέφει την πλήρη λίστα όλων των υποστηριζόμενων νομισμάτων. /api/codes (Εναλλακτική λύση: /api/currencies)
• Τελικό σημείο των τελευταίων τιμών. Αυτό το τελικό σημείο επιστρέφει δεδομένα συναλλαγματικής ισοτιμίας σε πραγματικό χρόνο για όλα τα υποστηριζόμενα νομίσματα. /api/latest
• Τελικό σημείο των ιστορικών επιτοκίων. Αυτό το τελικό σημείο επιστρέφει ιστορικά δεδομένα συναλλαγματικής ισοτιμίας για μια συγκεκριμένη ημερομηνία. /api/YYYY-MM-DD (Εναλλακτική λύση: /api/history?date=YYYY-MM-DD). Τα ιστορικά δεδομένα είναι διαθέσιμα από τις 4 Ιανουαρίου 1999.

Μεθοδολογία Συναλλαγματικής Ισοτιμίας

Για να διασφαλιστεί η ακρίβεια και η συνέπεια των δεδομένων, CurrencyRateAPI ακολουθεί μια αυστηρή μεθοδολογία για τη διαχείριση και την παροχή συναλλαγματικών ισοτιμιών:

• Μεσαίες τιμές αγοράς: Από προεπιλογή, το API επιστρέφει ποσοστά mid . Αυτά αντιπροσωπεύουν τον αριθμητικό μέσο όρο μεταξύ των τιμών αγοράς ( bid ) και πώλησης ( ask ) στην αγορά ή των επίσημων ισοτιμιών αναφοράς από τις κεντρικές τράπεζες.
• Οριστικοποίηση στο τέλος της ημέρας (EOD): Οι ιστορικές τιμές που παρέχονται από το API οριστικοποιούνται στο τέλος της ημέρας σε UTC (Συντονισμένη Παγκόσμια Ώρα).
• Υπολογισμός Σταυροειδούς Συντελεστή: Για ζεύγη νομισμάτων που δεν είναι άμεσα διαθέσιμα από τις πηγές μας, το σύστημα υπολογίζει αυτόματα εξαιρετικά ακριβείς διασταυρούμενες ισοτιμίες χρησιμοποιώντας τα κύρια παγκόσμια νομίσματα ως γέφυρα (pivot).
• Έξυπνος μηχανισμός εφεδρείας: Εάν τα δεδομένα για μια ζητούμενη ημερομηνία δεν είναι διαθέσιμα (π.χ., λόγω κλεισίματος της αγοράς τα Σαββατοκύριακα ή τις αργίες), το σύστημα αναζητά αυτόματα την πιο πρόσφατη έγκυρη τιμή εντός ενός κυλιόμενου παραθύρου 8 ημερών .
• Υψηλή ακρίβεια: Για την αποφυγή σφαλμάτων στρογγυλοποίησης στους οικονομικούς υπολογισμούς, οι συναλλαγματικές ισοτιμίες αποθηκεύονται και υποβάλλονται σε επεξεργασία με έως και 18 δεκαδικά ψηφία .

Τελικά σημεία

Υποστηριζόμενα σύμβολα στο τελικό σημείο

https://currencyrateapi.com/api/codes

Αυτό το τελικό σημείο επιστρέφει την πλήρη λίστα όλων των υποστηριζόμενων νομισμάτων. Μπορείτε επίσης να χρησιμοποιήσετε το ψευδώνυμο /api/currencies.

Μια αναγνώσιμη από τον άνθρωπο λίστα με όλα τα υποστηριζόμενα νομίσματα είναι επίσης διαθέσιμη στη σελίδα μας με τα Υποστηριζόμενα Νομίσματα .

Βασικά Νομίσματα: Από προεπιλογή, ορισμένα άλλα τελικά σημεία (όπως τα /latest και /{YYYY-MM-DD}) επιστρέφουν ένα περιορισμένο σύνολο κύριων παγκόσμιων νομισμάτων για την ελαχιστοποίηση της επισκεψιμότητας. Αυτά τα "βασικά" νομίσματα είναι:

USD, EUR, GBP, CHF, JPY, CAD, AUD, NZD, SEK, NOK, DKK, ISK, PLN, CZK, HUF, RON, HRK, RSD,
MKD, MDL, TRY, SGD, HKD, KRW, TWD, ILS, AED, SAR, QAR, KWD, BHD, OMR, ZAR

Απόκριση API:

{
    "success": true,
    "currencies": {
        "EUR": {
            "entity": "EUROPEAN UNION",
            "currency": "Euro",
            "alphabetic_code": "EUR",
            "numeric_code": 978,
            "minor_unit": 2,
            "title": "Euro",
            "symbol": "€",
            "data_from": "1999-01-04"
        },
        "BTC": {
            "entity": "CRYPTOCURRENCY",
            "currency": "Bitcoin",
            "alphabetic_code": "BTC",
            "title": "Bitcoin",
            "symbol": "₿",
            "is_crypto": true,
            "data_from": "2024-03-02"
        },
        [...]
    }
}

Αντικείμενα απόκρισης:

Τελευταίες τιμές στο τελικό σημείο

https://currencyrateapi.com/api/latest?
    base=USD&
    quote=GBP,JPY,EUR

Παράμετροι αιτήματος:

Απόκριση API:

{
    "success": true,
    "base": "usd",
    "date": "2026-01-22",
    "rates": {
        "gbp": "0.74350935478637",
        "jpy": "158.00358051914",
        "eur": "0.8518613169776"
    },
    "last_update_unix": "1769067006"
}

Αντικείμενα απόκρισης:

Τελικό σημείο ιστορικών τιμών

https://currencyrateapi.com/api/2025-08-25?
    base=EUR&
    quote=USD,GBP,CAD

Εναλλακτική μορφή: /api/history?date=2025-08-25...

Παράμετροι αιτήματος:

Απόκριση API:

{
    "success": true,
    "base": "eur",
    "date": "2025-08-25",
    "rates": {
        "usd": "1.1697",
        "gbp": "0.8659",
        "cad": "1.6171"
    },
    "last_update_unix": "1769067006"
}

Αντικείμενα απόκρισης:

Δείγμα κώδικα

PHP (cURL)

// Set API Endpoint (can be 'latest' or a date 'YYYY-MM-DD')
$endpoint = 'latest';

// Initialize CURL:
$ch = curl_init('https://currencyrateapi.com/api/'.$endpoint.'?base=USD"e=GBP,JPY');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Store the data:
$json = curl_exec($ch);
curl_close($ch);

// Decode JSON response:
$exchangeRates = json_decode($json, true);

// Access the exchange rate values, e.g. GBP:
echo $exchangeRates['rates']['GBP'];

JavaScript (ανάκτηση)

 // Set endpoint (can be 'latest' or a date 'YYYY-MM-DD')
const endpoint = 'latest';
const params = '?base=USD"e=GBP,JPY';

// Get exchange rates via the selected endpoint:
fetch('https://currencyrateapi.com/api/' + endpoint + params)
    .then(response => {
        return response.json();
    })
    .then(json => {

        // Exchange rate data is stored in json.rates
        console.log(json.rates.GBP);

        // Timestamp can be accessed in json.last_update_unix
        console.log(json.last_update_unix);
    })
    .catch(error => {
        console.error('Fetch error:', error);
    });