Bắt đầu

API của Finexly cung cấp tỷ giá hối đoái theo thời gian thực và lịch sử cho hơn 170 loại tiền tệ. Bắt đầu rất dễ dàng:

  1. Đăng ký tài khoản miễn phí
  2. Lấy khóa truy cập API của bạn từ bảng điều khiển
  3. Thực hiện yêu cầu API đầu tiên của bạn

URL cơ bản

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

Xác thực

Tất cả các yêu cầu API đều cần xác thực qua mã thông báo Bearer. Bao gồm khóa API của bạn trong tiêu đề Authorization:

Tiêu đề Ủy quyền (Bắt buộc)

Authorization: Bearer YOUR_API_KEY

Giới hạn Tốc độ: Kiểm tra tiêu đề phản hồi để biết mức sử dụng hiện tại của bạn: X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Units

Điểm cuối API

GET /v1/currencies

Lấy danh sách tất cả các mã tiền tệ được hỗ trợ.

Tham số

Tên Loại Bắt buộc Mô tả

Ví dụ

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

// Phản hồi
[
    "AED",
    "ANG",
    "AUD",
    "EUR",
    "GBP",
    "USD"
]
GET /v1/rate

Lấy tỷ giá hối đoái cho một cặp tiền tệ cụ thể.

Tham số

Tên Loại Bắt buộc Mô tả
from string Mã tiền tệ cơ sở (chữ hoa)
to string Mã tiền tệ báo giá (chữ hoa)

Ví dụ

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

// Phản hồi
{
    "pair": "USD_EUR",
    "rate": 0.9215
}
GET /v1/convert

Lấy tỷ giá hối đoái cho nhiều cặp tiền tệ trong một yêu cầu.

Tham số

Tên Loại Bắt buộc Mô tả
q string Các cặp phân cách bằng dấu phẩy theo định dạng BASE_QUOTE

Ví dụ

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

// Phản hồi
{
    "USD_EUR": {
        "rate": 0.9215
    },
    "USD_GBP": {
        "rate": 0.7892
    }
}
GET /v1/convert-amount

Chuyển đổi một số tiền cụ thể từ loại tiền này sang loại tiền khác.

Tham số

Tên Loại Bắt buộc Mô tả
from string Mã tiền tệ nguồn (chữ hoa)
to string Mã tiền tệ đích (chữ hoa)
amount number Số tiền cần chuyển đổi

Ví dụ

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

// Phản hồi
{
    "pair": "USD_EUR",
    "rate": 0.9215,
    "amount": 100,
    "result": 92.15
}

Ví dụ mã

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

Mã lỗi

Loại Mô tả
400 BAD_REQUEST Tham số yêu cầu không hợp lệ hoặc thiếu các trường bắt buộc.
401 UNAUTHORIZED Token API bị thiếu hoặc không hợp lệ.
403 FORBIDDEN Quyền truy cập bị từ chối. Tài khoản của bạn có thể không hoạt động.
413 PAYLOAD_TOO_LARGE Kích thước yêu cầu vượt quá kích thước tối đa cho phép.
429 RATE_LIMIT_EXCEEDED Bạn đã vượt quá giới hạn tốc độ. Kiểm tra headers X-RateLimit.
500 INTERNAL_ERROR Đã xảy ra lỗi máy chủ nội bộ. Vui lòng thử lại.