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:
- Đăng ký tài khoản miễn phí
- Lấy khóa truy cập API của bạn từ bảng điều khiển
- 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:
Tùy chọn 1: Tiêu đề Ủy quyền (Khuyến nghị)
Tiêu đề Ủy quyền (Bắt buộc)
Authorization: Bearer YOUR_API_KEY
Tùy chọn 2: Tham số truy vấn
Truyền khóa API của bạn dưới dạng tham số truy vấn:
GET https://api.finexly.com/v1/rate?from=USD&to=EUR&api_key=YOUR_API_KEY
⚠ Lưu ý bảo mật: Khóa API trong URL có thể được ghi lại trong nhật ký truy cập máy chủ và có thể bị rò rỉ qua tiêu đề HTTP Referrer. Đối với sử dụng trong môi trường sản xuất, chúng tôi khuyến nghị phương pháp tiêu đề Authorization. Tham số truy vấn được cung cấp như một tiện ích để thử nghiệm nhanh và tích hợp đơn giản.
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
/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"
]
/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 | Có | Mã tiền tệ cơ sở (chữ hoa) |
| to | string | Có | 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
}
/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 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
}
}
/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 | Có | Mã tiền tệ nguồn (chữ hoa) |
| to | string | Có | Mã tiền tệ đích (chữ hoa) |
| amount | number | Có | 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ã
# 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")
Mã lỗi
| Mã | 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. |