Kom i gang

Finexly API gir sanntids- og historiske valutakurser for 170+ valutaer. Det er enkelt å komme i gang:

  1. Registrer deg for en gratis konto
  2. Hent API-tilgangsnøkkelen fra dashbordet
  3. Utfør din første API-forespørsel

Grunnleggende URL

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

Autentisering

Alle API-forespørsler krever autentisering via Bearer-token. Inkluder API-nøkkelen din i Authorization-headeren:

Autorisasjonsoverskrift (Påkrevd)

Authorization: Bearer YOUR_API_KEY

Begrensning av hastighet: Sjekk responsoverskriftene for din nåværende bruk: X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Units

API-endepunkter

GET /v1/currencies

Hent en liste over alle støttede valutakoder.

Parametere

Navn Type Påkrevd Beskrivelse

Eksempel

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

// Respons
[
    "AED",
    "ANG",
    "AUD",
    "EUR",
    "GBP",
    "USD"
]
GET /v1/rate

Hent valutakursen for et spesifikt valutapar.

Parametere

Navn Type Påkrevd Beskrivelse
from string Ja Basisvalutakode (store bokstaver)
to string Ja Kursvalutakode (store bokstaver)

Eksempel

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

// Respons
{
    "pair": "USD_EUR",
    "rate": 0.9215
}
GET /v1/convert

Hent valutakurser for flere valutapar i én enkelt forespørsel.

Parametere

Navn Type Påkrevd Beskrivelse
q string Ja Kommaseparerte par i BASIS_KURS format

Eksempel

GET https://api.finexly.com/v1/convert?q=USD_EUR,USD_GBP

// Respons
{
    "USD_EUR": {
        "rate": 0.9215
    },
    "USD_GBP": {
        "rate": 0.7892
    }
}
GET /v1/convert-amount

Konverter et spesifikt beløp fra én valuta til en annen.

Parametere

Navn Type Påkrevd Beskrivelse
from string Ja Kildevalutakode (store bokstaver)
to string Ja Målvalutakode (store bokstaver)
amount number Ja Beløp som skal konverteres

Eksempel

GET https://api.finexly.com/v1/convert-amount?from=USD&to=EUR&amount=100

// Respons
{
    "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")

Feilkoder

Kode Type Beskrivelse
400 BAD_REQUEST Ugyldige forespørselsparametere eller manglende obligatoriske felt.
401 UNAUTHORIZED API-token mangler eller er ugyldig.
403 FORBIDDEN Tilgang nektet. Kontoen din kan være inaktiv.
413 PAYLOAD_TOO_LARGE Forespørselsstørrelsen overskrider maksimal tillatt størrelse.
429 RATE_LIMIT_EXCEEDED Du har overskredet hastighetsgrensen din. Sjekk X-RateLimit-hodene.
500 INTERNAL_ERROR Det oppstod en intern serverfeil. Vennligst prøv igjen.