Ξεκινώντας
Το API της Finexly παρέχει συναλλαγματικές ισοτιμίες σε πραγματικό χρόνο και ιστορικά δεδομένα για 170+ νομίσματα. Η έναρξη είναι εύκολη:
- Εγγραφείτε για δωρεάν λογαριασμό
- Λάβετε το κλειδί πρόσβασης API από τον πίνακα ελέγχου
- Κάντε το πρώτο σας αίτημα API
Βασική διεύθυνση URL
https://api.finexly.com/v1/
Ταυτοποίηση
Όλα τα αιτήματα API απαιτούν αυθεντικοποίηση μέσω Bearer token. Συμπεριλάβετε το API key σας στην κεφαλίδα Authorization:
Επιλογή 1: Κεφαλίδα Εξουσιοδότησης (Συνιστάται)
Κεφαλίδα Εξουσιοδότησης (Απαιτείται)
Authorization: Bearer YOUR_API_KEY
Επιλογή 2: Παράμετρος Ερωτήματος
Περάστε το κλειδί API σας ως παράμετρο ερωτήματος:
GET https://api.finexly.com/v1/rate?from=USD&to=EUR&api_key=YOUR_API_KEY
⚠ Σημείωση Ασφαλείας: Τα κλειδιά API στις διευθύνσεις URL μπορεί να καταγραφούν στα αρχεία καταγραφής πρόσβασης του διακομιστή και να διαρρεύσουν μέσω των κεφαλίδων HTTP Referrer. Για χρήση σε παραγωγή, συνιστούμε τη μέθοδο της κεφαλίδας Authorization. Η παράμετρος ερωτήματος παρέχεται για ευκολία σε γρήγορες δοκιμές και απλές ενσωματώσεις.
Περιορισμός Ρυθμού: Ελέγξτε τις κεφαλίδες απόκρισης για την τρέχουσα χρήση σας:
X-RateLimit-Limit,
X-RateLimit-Used,
X-RateLimit-Units
Σημεία Τερματισμού API
/v1/currencies
Λήψη λίστας όλων των υποστηριζόμενων κωδικών νομισμάτων.
Παράμετροι
| Όνομα | Τύπος | Απαιτείται | Περιγραφή |
|---|
Παράδειγμα
GET https://api.finexly.com/v1/currencies
// Απάντηση
[
"AED",
"ANG",
"AUD",
"EUR",
"GBP",
"USD"
]
/v1/rate
Λήψη της συναλλαγματικής ισοτιμίας για ένα συγκεκριμένο ζεύγος νομισμάτων.
Παράμετροι
| Όνομα | Τύπος | Απαιτείται | Περιγραφή |
|---|---|---|---|
| from | string | Ναι | Κωδικός βασικού νομίσματος (κεφαλαία) |
| to | string | Ναι | Κωδικός νομίσματος τιμής (κεφαλαία) |
Παράδειγμα
GET https://api.finexly.com/v1/rate?from=USD&to=EUR
// Απάντηση
{
"pair": "USD_EUR",
"rate": 0.9215
}
/v1/convert
Λήψη συναλλαγματικών ισοτιμιών για πολλαπλά ζεύγη νομισμάτων σε ένα αίτημα.
Παράμετροι
| Όνομα | Τύπος | Απαιτείται | Περιγραφή |
|---|---|---|---|
| q | string | Ναι | Ζεύγη χωρισμένα με κόμμα σε μορφή BASE_QUOTE |
Παράδειγμα
GET https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP
// Απάντηση
{
"USD_EUR": {
"rate": 0.9215
},
"USD_GBP": {
"rate": 0.7892
}
}
/v1/convert-amount
Μετατροπή συγκεκριμένου ποσού από ένα νόμισμα σε άλλο.
Παράμετροι
| Όνομα | Τύπος | Απαιτείται | Περιγραφή |
|---|---|---|---|
| from | string | Ναι | Κωδικός νομίσματος πηγής (κεφαλαία) |
| to | string | Ναι | Κωδικός νομίσματος στόχου (κεφαλαία) |
| amount | number | Ναι | Ποσό προς μετατροπή |
Παράδειγμα
GET https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100
// Απάντηση
{
"pair": "USD_EUR",
"rate": 0.9215,
"amount": 100,
"result": 92.15
}
Παραδείγματα Κώδικα
# Using Authorization header (recommended)
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.finexly.com/v1/rate?from=USD&to=EUR"
# Using query parameter
curl "https://api.finexly.com/v1/rate?from=USD&to=EUR&api_key=YOUR_API_KEY"
# Get multiple rates
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP"
# Convert amount
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100"
<?php
$apiKey = 'YOUR_API_KEY';
// Using cURL
$ch = curl_init();
curl_setopt_array($ch, [
CURLOPT_URL => 'https://api.finexly.com/v1/rate?from=USD&to=EUR',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $apiKey,
],
]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
echo "USD/EUR Rate: " . $data['rate'];
const apiKey = 'YOUR_API_KEY';
// Get single rate
const response = await fetch('https://api.finexly.com/v1/rate?from=USD&to=EUR', {
headers: {
'Authorization': `Bearer ${apiKey}`
}
});
const data = await response.json();
console.log(`USD/EUR Rate: ${data.rate}`);
// Convert amount
const convertResponse = await fetch(
'https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100',
{ headers: { 'Authorization': `Bearer ${apiKey}` } }
);
const result = await convertResponse.json();
console.log(`100 USD = ${result.result} EUR`);
import requests
api_key = 'YOUR_API_KEY'
headers = {'Authorization': f'Bearer {api_key}'}
# Get single rate
response = requests.get(
'https://api.finexly.com/v1/rate',
params={'from': 'USD', 'to': 'EUR'},
headers=headers
)
data = response.json()
print(f"USD/EUR Rate: {data['rate']}")
# Convert amount
response = requests.get(
'https://api.finexly.com/v1/convert-amount',
params={'from': 'USD', 'to': 'EUR', 'amount': 100},
headers=headers
)
result = response.json()
print(f"100 USD = {result['result']} EUR")
Κωδικοί Σφαλμάτων
| Κωδικός | Τύπος | Περιγραφή |
|---|---|---|
| 400 | BAD_REQUEST | Μη έγκυρες παράμετροι αιτήματος ή απουσιάζουν υποχρεωτικά πεδία. |
| 401 | UNAUTHORIZED | Το API token λείπει ή δεν είναι έγκυρο. |
| 403 | FORBIDDEN | Η πρόσβαση απορρίφθηκε. Ο λογαριασμός σας μπορεί να είναι ανενεργός. |
| 413 | PAYLOAD_TOO_LARGE | Το μέγεθος του αιτήματος υπερβαίνει το μέγιστο επιτρεπόμενο μέγεθος. |
| 429 | RATE_LIMIT_EXCEEDED | Έχετε υπερβεί το όριο ρυθμού σας. Ελέγξτε τα headers X-RateLimit. |
| 500 | INTERNAL_ERROR | Προέκυψε εσωτερικό σφάλμα διακομιστή. Δοκιμάστε ξανά. |
Συνδέσεις AI (MCP)
Η Finexly υποστηρίζει το Πρωτόκολλο Συμφραζομένων Μοντέλου, έτσι ώστε ένας AI βοηθός να μπορεί να διαβάζει τις τιμές απευθείας αντί να τις παραλαμβάνει. Αυτό είναι ένα ξεχωριστό κανάλι από το REST API παρακάτω: αυθεντικοποιείται με OAuth αντί για κλειδί API και είναι μόνο για ανάγνωση.
Διεύθυνση URL διακομιστή
https://mcp.finexly.com
Εργαλεία που εκθέτει
| Όνομα | Περιγραφή |
|---|---|
| get_exchange_rate | Η τρέχουσα ισοτιμία μεταξύ δύο νομισμάτων. |
| convert_amount | Μετατρέψτε ένα ποσό, διασταυρωμένο μέσω του αμερικανικού δολαρίου όπου χρειάζεται. |
| list_currencies | Κάθε νόμισμα που καλύπτουμε. |
| get_historical_rates | Ημερήσιες τιμές σε μια περίοδο, για ζεύγη που συλλέγονται άμεσα. |
Εξουσιοδότηση
Ο συνδετήρας εκτελεί μια ροή κωδικού εξουσιοδότησης OAuth 2.1 με PKCE. Η ανακάλυψη βρίσκεται στα παρακάτω URLs; η μόνη έκταση είναι το fx:read, και δεν υπάρχει καμία έκταση που να παρέχει πρόσβαση σε λογαριασμό.
- https://finexly.com/.well-known/oauth-authorization-server
- https://finexly.com/oauth/authorize
- https://finexly.com/oauth/token
- https://finexly.com/oauth/jwks
Tutorials & Guides
Learn how to integrate Finexly with your favorite programming languages and frameworks.
JavaScript Integration Tutorial
Step-by-step guide to integrating Finexly API with JavaScript and Node.js.
Python Integration Tutorial
Complete guide to using Finexly API with Python and popular libraries.
Developer Guide
Comprehensive guide to free currency API features and best practices.
Historical Rates Guide
Learn how to retrieve and work with historical exchange rate data.