Ξεκινώντας

Το API της Finexly παρέχει συναλλαγματικές ισοτιμίες σε πραγματικό χρόνο και ιστορικά δεδομένα για 170+ νομίσματα. Η έναρξη είναι εύκολη:

  1. Εγγραφείτε για δωρεάν λογαριασμό
  2. Λάβετε το κλειδί πρόσβασης API από τον πίνακα ελέγχου
  3. Κάντε το πρώτο σας αίτημα API

Βασική διεύθυνση URL

https://api.finexly.com/v1/

Ταυτοποίηση

Όλα τα αιτήματα API απαιτούν αυθεντικοποίηση μέσω Bearer token. Συμπεριλάβετε το API key σας στην κεφαλίδα Authorization:

Κεφαλίδα Εξουσιοδότησης (Απαιτείται)

Authorization: Bearer YOUR_API_KEY

Περιορισμός Ρυθμού: Ελέγξτε τις κεφαλίδες απόκρισης για την τρέχουσα χρήση σας: X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Units

Σημεία Τερματισμού API

GET /v1/currencies

Λήψη λίστας όλων των υποστηριζόμενων κωδικών νομισμάτων.

Παράμετροι

Όνομα Τύπος Απαιτείται Περιγραφή

Παράδειγμα

GET https://api.finexly.com/v1/currencies

// Απάντηση
[
    "AED",
    "ANG",
    "AUD",
    "EUR",
    "GBP",
    "USD"
]
GET /v1/rate

Λήψη της συναλλαγματικής ισοτιμίας για ένα συγκεκριμένο ζεύγος νομισμάτων.

Παράμετροι

Όνομα Τύπος Απαιτείται Περιγραφή
from string Ναι Κωδικός βασικού νομίσματος (κεφαλαία)
to string Ναι Κωδικός νομίσματος τιμής (κεφαλαία)

Παράδειγμα

GET https://api.finexly.com/v1/rate?from=USD&to=EUR

// Απάντηση
{
    "pair": "USD_EUR",
    "rate": 0.9215
}
GET /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
    }
}
GET /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
}

Παραδείγματα Κώδικα

# Get single rate
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.finexly.com/v1/rate?from=USD&to=EUR"

# Get multiple rates
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP,BTC_USD"

# 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 Προέκυψε εσωτερικό σφάλμα διακομιστή. Δοκιμάστε ξανά.