Aloittaminen

Finexly API tarjoaa reaaliaikaiset ja historialliset valuuttakurssit yli 170 valuutalle. Aloittaminen on helppoa:

  1. Rekisteröidy ilmaiseksi tilille
  2. Hae API-käyttöavain hallintapaneelista
  3. Tee ensimmäinen API-pyyntösi

Perus-URL-osoite

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

Todennus

Kaikki API-pyynnöt vaativat todennuksen Bearer-tokenin avulla. Sisällytä API-avaimesi Authorization-otsikkoon:

Valtuutuksen otsake (Vaaditaan)

Authorization: Bearer YOUR_API_KEY

Nopeusrajoitus: Tarkista vastausotsikoista nykyinen käyttötasosi. X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Units

API-päätepisteet

GET /v1/currencies

Hae luettelo kaikista tuetuista valuuttakoodeista.

Parametrit

Nimi Tyyppi Pakollinen Kuvaus

Esimerkki

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

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

Hae valuuttakurssi tietylle valuuttaparille.

Parametrit

Nimi Tyyppi Pakollinen Kuvaus
from string Kyllä Perusvaluuttakoodi (isot kirjaimet)
to string Kyllä Noteerausvaluuttakoodi (isot kirjaimet)

Esimerkki

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

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

Hae valuuttakurssit useille valuuttapareille yhdellä pyynnöllä.

Parametrit

Nimi Tyyppi Pakollinen Kuvaus
q string Kyllä Pilkulla erotetut parit muodossa PERUSTA_NOTEERAUS

Esimerkki

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

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

Muunna tietty summa yhdestä valuutasta toiseen.

Parametrit

Nimi Tyyppi Pakollinen Kuvaus
from string Kyllä Lähdevaluuttakoodi (isot kirjaimet)
to string Kyllä Kohdevaluuttakoodi (isot kirjaimet)
amount number Kyllä Muunnettava summa

Esimerkki

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

// Vastaus
{
    "pair": "USD_EUR",
    "rate": 0.9215,
    "amount": 100,
    "result": 92.15
}

Koodiesimerkit

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

Virhekoodit

Koodi Tyyppi Kuvaus
400 BAD_REQUEST Virheelliset pyyntöparametrit tai puuttuvat pakolliset kentät.
401 UNAUTHORIZED API-token puuttuu tai on virheellinen.
403 FORBIDDEN Pääsy estetty. Tilisi voi olla passiivinen.
413 PAYLOAD_TOO_LARGE Pyynnön koko ylittää suurimman sallitun koon.
429 RATE_LIMIT_EXCEEDED Olet ylittänyt nopeusrajasi. Tarkista X-RateLimit-otsikot.
500 INTERNAL_ERROR Tapahtui sisäinen palvelinvirhe. Yritä uudelleen.