はじめに

Finexly APIは、170以上の通貨のリアルタイムおよび過去の為替レートを提供します。始めるのは簡単です：

  1. 無料アカウントに登録する
  2. ダッシュボードからAPIアクセスキーを取得してください
  3. 最初のAPIリクエストを作成する

ベースURL

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

認証

すべてのAPIリクエストにはBearerトークンによる認証が必要です。APIキーをAuthorizationヘッダーに含めてください。

オプション1: 認証ヘッダー (推奨)

認証ヘッダー（必須）

Authorization: Bearer YOUR_API_KEY

オプション2: クエリパラメータ

APIキーをクエリパラメータとして渡します。

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

⚠ セキュリティ注意: URL内のAPIキーはサーバーアクセスログに記録される可能性があり、HTTPリファラーヘッダーを通じて漏洩することがあります。本番環境での使用には、Authorizationヘッダー方式を推奨します。クエリパラメータは、迅速なテストや簡単な統合のための便宜として提供されています。

レート制限: 現在の使用状況はレスポンスヘッダーを確認してください。 X-RateLimit-Limit, X-RateLimit-Used, X-RateLimit-Units

APIエンドポイント

GET /v1/currencies

サポートされているすべての通貨コードのリストを取得します。

パラメータ

名前 タイプ 必須 説明

例

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

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

特定の通貨ペアの為替レートを取得します。

パラメータ

名前 タイプ 必須 説明
from string はい 基準通貨コード（大文字）
to string はい 相場通貨コード（大文字）

例

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

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

1回のリクエストで複数の通貨ペアの為替レートを取得します。

パラメータ

名前 タイプ 必須 説明
q string はい BASE_QUOTE形式のカンマ区切りペア

例

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

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

特定の金額をある通貨から別の通貨に変換します。

パラメータ

名前 タイプ 必須 説明
from string はい 変換元通貨コード（大文字）
to string はい 変換先通貨コード（大文字）
amount number はい 変換する金額

例

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

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

コード例

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

エラーコード

コード タイプ 説明
400 BAD_REQUEST 無効なリクエストパラメータまたは必須フィールドの欠落。
401 UNAUTHORIZED APIトークンが見つからないか無効です。
403 FORBIDDEN アクセスが拒否されました。アカウントが非アクティブの可能性があります。
413 PAYLOAD_TOO_LARGE リクエストペイロードが最大許容サイズを超えています。
429 RATE_LIMIT_EXCEEDED レート制限を超えました。X-RateLimitヘッダーを確認してください。
500 INTERNAL_ERROR 内部サーバーエラーが発生しました。もう一度お試しください。

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.