為替レートを取得
指定された通貨ペアの現在の外国為替レートを取得します。複数通貨取引に使用されるリアルタイムの為替レートを返します。このエンドポイントは、アカウントで複数通貨取引が有効になっている場合にのみアクセス可能です。
リクエストパラメータ
必須 - 1項目必須パラメータ
`currency`STRING(required)
小文字のISO 4217の3文字通貨コードとしての基準通貨。レートはこの通貨からアカウントの資金調達通貨への換算を表示します。
レスポンス
200
リクエスト成功現在の為替レート情報を含む為替オブジェクトを返します。
為替オブジェクトには以下が含まれます:
object- 文字列値「forex」location- APIエンドポイントパス（例: 「/forex/usd」）livemode- テストモードか本番モードかを示すブール値base- ソース通貨コード（ISO 4217）quote- ターゲット通貨コード（通常はアカウントの資金調達通貨）rate- 数値の為替レート（仲値日次レートより約2-4%高い）
- レートは、基準通貨1単位が見積もり通貨何単位に相当するかを表します
- 例: base=USD、quote=THB、rate=30.4847の場合、1 USD = 30.4847 THB
- レートにはOmiseのマージン（仲値レートより2-4%高い）が含まれます
401
認証失敗認証に失敗しました。無効または欠落したAPIキー。
一般的な原因:
- Authorizationヘッダーがない
- 無効な秘密キー
- 不正なHTTP Basic Auth形式
404
見つからない通貨が見つからないか、複数通貨が有効になっていません。
一般的な原因:
- 無効な通貨コード
- アカウントで複数通貨取引が有効になっていない
- アカウントでサポートされていない通貨
5xx
サーバーエラーサーバーサイドエラーが発生しました。これらはまれですが、適切に処理する必要があります。
対処方法:
- 指数バックオフでリクエストを再試行
- status.omise.coでサービスインシデントを確認
- 詳細なガイダンスはエラー処理を参照
コードサンプル
- cURL
- Ruby
- Python
- Node.js
- PHP
- Java
- C#
- Go
curl https://api.omise.co/forex/usd \
-u skey_test_5xuy4w91xqz7d1w9u0t:
require 'omise'
Omise.api_key = 'skey_test_5xuy4w91xqz7d1w9u0t'
forex = Omise::Forex.retrieve('usd')
import omise
omise.api_secret = 'skey_test_5xuy4w91xqz7d1w9u0t'
forex = omise.Forex.retrieve('usd')
const omise = require('omise')({
secretKey: 'skey_test_5xuy4w91xqz7d1w9u0t'
});
const forex = await omise.forex.retrieve('usd');
<?php
define('OMISE_SECRET_KEY', 'skey_test_5xuy4w91xqz7d1w9u0t');
$forex = OmiseForex::retrieve('usd');
Client client = new Client.Builder()
.secretKey("skey_test_5xuy4w91xqz7d1w9u0t")
.build();
ForexRate forex = client.forex("usd").get();
var client = new Client("skey_test_5xuy4w91xqz7d1w9u0t");
var forex = await client.Forex.Retrieve("usd");
client, _ := omise.NewClient(
"pkey_test_5xuy4w91xqz7d1w9u0t",
"skey_test_5xuy4w91xqz7d1w9u0t",
)
forex, _ := client.Forex().Get("usd")
API認証情報
試してみる
必須 - 1項目
あなたのIP:
...読み込み中...