Kom godt i gang
Finexly API'en leverer realtids- og historiske valutakurser for 170+ valutaer. Det er nemt at komme i gang:
- Tilmeld dig en gratis konto
- Hent din API-adgangsnøgle fra instrumentbrættet
- Foretag din første API-anmodning
Basis-URL
https://api.finexly.com/v1/
Godkendelse
Alle API-anmodninger kræver autentificering via Bearer-token. Inkluder din API-nøgle i Authorization-headeren:
Mulighed 1: Autorisationshoved (Anbefalet)
Autorisationsheader (Påkrævet)
Authorization: Bearer YOUR_API_KEY
Mulighed 2: Forespørgselsparameter
Angiv din API-nøgle som en forespørgselsparameter:
GET https://api.finexly.com/v1/rate?from=USD&to=EUR&api_key=YOUR_API_KEY
⚠ Sikkerhedsnote: API-nøgler i URL'er kan blive logget i serveradgangslogfiler og kan lække via HTTP Referrer-headere. Til produktionsbrug anbefaler vi metoden med Authorization-header. Forespørgselsparameteren er tilgængelig som en bekvemmelighed for hurtig test og enkle integrationer.
Begrænsning af rater: Tjek svaroverskrifter for dit nuværende forbrug:
X-RateLimit-Limit,
X-RateLimit-Used,
X-RateLimit-Units
API-endepunkter
/v1/currencies
Hent en liste over alle understøttede valutakoder.
Parametre
| Navn | Type | Påkrævet | Beskrivelse |
|---|
Eksempel
GET https://api.finexly.com/v1/currencies
// Svar
[
"AED",
"ANG",
"AUD",
"EUR",
"GBP",
"USD"
]
/v1/rate
Hent valutakursen for et specifikt valutapar.
Parametre
| Navn | Type | Påkrævet | Beskrivelse |
|---|---|---|---|
| from | string | Ja | Basisvalutakode (store bogstaver) |
| to | string | Ja | Kursvalutakode (store bogstaver) |
Eksempel
GET https://api.finexly.com/v1/rate?from=USD&to=EUR
// Svar
{
"pair": "USD_EUR",
"rate": 0.9215
}
/v1/convert
Hent valutakurser for flere valutapar i en enkelt anmodning.
Parametre
| Navn | Type | Påkrævet | Beskrivelse |
|---|---|---|---|
| q | string | Ja | Kommaseparerede par i BASIS_KURS format |
Eksempel
GET https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP
// Svar
{
"USD_EUR": {
"rate": 0.9215
},
"USD_GBP": {
"rate": 0.7892
}
}
/v1/convert-amount
Konverter et specifikt beløb fra én valuta til en anden.
Parametre
| Navn | Type | Påkrævet | Beskrivelse |
|---|---|---|---|
| from | string | Ja | Kildevalutakode (store bogstaver) |
| to | string | Ja | Målvalutakode (store bogstaver) |
| amount | number | Ja | Beløb der skal konverteres |
Eksempel
GET https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100
// Svar
{
"pair": "USD_EUR",
"rate": 0.9215,
"amount": 100,
"result": 92.15
}
Kodeeksempler
# 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")
Fejlkoder
| Kode | Type | Beskrivelse |
|---|---|---|
| 400 | BAD_REQUEST | Ugyldige forespørgselsparametre eller manglende påkrævede felter. |
| 401 | UNAUTHORIZED | API-token mangler eller er ugyldig. |
| 403 | FORBIDDEN | Adgang nægtet. Din konto er muligvis inaktiv. |
| 413 | PAYLOAD_TOO_LARGE | Forespørgslens størrelse overstiger maksimal tilladt størrelse. |
| 429 | RATE_LIMIT_EXCEEDED | Du har overskredet din hastighedsgrænse. Tjek X-RateLimit headers. |
| 500 | INTERNAL_ERROR | Der opstod en intern serverfejl. Prøv venligst igen. |
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.