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:

Alternativ 1: Auktoriseringshuvud (Rekommenderas)

Auktoriseringshuvud (Obligatoriskt)

Authorization: Bearer YOUR_API_KEY

Alternativ 2: Frågeparameter

Skicka din API-nyckel som en frågeparameter:

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

⚠ Säkerhetsnotering: API-nycklar i URL:er kan loggas i serverns åtkomstloggar och kan läcka via HTTP Referrer-headers. För produktionsanvändning rekommenderar vi metoden med Authorization-header. Frågeparametern tillhandahålls som en bekvämlighet för snabb testning och enkla integrationer.

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

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

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.

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.