Kom godt i gang

Finexly API'en leverer realtids- og historiske valutakurser for 170+ valutaer. Det er nemt at komme i gang:

  1. Tilmeld dig en gratis konto
  2. Hent din API-adgangsnøgle fra instrumentbrættet
  3. 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:

Autorisationsheader (Påkrævet)

Authorization: Bearer YOUR_API_KEY

Begrænsning af rater: Tjek svaroverskrifter for dit nuværende forbrug: X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Units

API-endepunkter

GET /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"
]
GET /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
}
GET /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
    }
}
GET /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

# 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")

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.