Komma igång

Finexly API tillhandahåller realtids- och historiska växelkurser för 170+ valutor. Att komma igång är enkelt:

  1. Registrera dig för ett gratis konto
  2. Hämta din API-åtkomstnyckel från instrumentpanelen
  3. Gör din första API-förfrågan

Bas-URL

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

Autentisering

Alla API-förfrågningar kräver autentisering via Bearer-token. Inkludera din API-nyckel i Authorization-headern:

Auktoriseringshuvud (Obligatoriskt)

Authorization: Bearer YOUR_API_KEY

Begränsning av hastighet: Kontrollera svarshuvuden för din nuvarande användning: X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Units

API-slutpunkter

GET /v1/currencies

Hämta en lista över alla valutakoder som stöds.

Parametrar

Namn Typ Obligatorisk Beskrivning

Exempel

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

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

Hämta växelkursen för ett specifikt valutapar.

Parametrar

Namn Typ Obligatorisk Beskrivning
from string Ja Basvalutakod (versaler)
to string Ja Kursvalutakod (versaler)

Exempel

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

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

Hämta växelkurser för flera valutapar i en enda förfrågan.

Parametrar

Namn Typ Obligatorisk Beskrivning
q string Ja Kommaseparerade par i formatet BAS_KURS

Exempel

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

Konvertera ett specifikt belopp från en valuta till en annan.

Parametrar

Namn Typ Obligatorisk Beskrivning
from string Ja Källvalutakod (versaler)
to string Ja Målvalutakod (versaler)
amount number Ja Belopp att konvertera

Exempel

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
}

Kodexempel

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

Felkoder

Kod Typ Beskrivning
400 BAD_REQUEST Ogiltiga förfrågningsparametrar eller saknade obligatoriska fält.
401 UNAUTHORIZED API-token saknas eller är ogiltig.
403 FORBIDDEN Åtkomst nekad. Ditt konto kan vara inaktivt.
413 PAYLOAD_TOO_LARGE Förfrågans storlek överskrider maximal tillåten storlek.
429 RATE_LIMIT_EXCEEDED Du har överskridit din hastighetsgräns. Kontrollera X-RateLimit-headers.
500 INTERNAL_ERROR Ett internt serverfel inträffade. Försök igen.