データ形式と単位

レートは2方向で表される

リクエストした各シンボルについて、ratesには2つの数値が含まれます。基準通貨がUSDの場合の金（XAU）の例：

• USDXAU：金1トロイオンスの米ドル建て価格（例：3997.89）。ユーザーに表示するのはこの数値です。
• XAU：その逆数で、1米ドルあたりの金のトロイオンス数（例：0.0002501319446）。この形式は、為替系APIとの互換性のために残されています。

通貨も同じルールに従います。基準通貨がUSDの場合、USDEURは1ユーロの米ドル建て価格、EURは1米ドルあたりのユーロ額です。

{
  "success": true,
  "timestamp": 1792765800,
  "date": "2026-10-23",
  "base": "USD",
  "rates": {
    "XAU": 0.0002501319446,
    "USDXAU": 3997.89,
    "EUR": 0.8589589418,
    "USDEUR": 1.1642
  }
}

基準通貨を選ぶ

baseは、レスポンス内のすべての価格の通貨を指定します。デフォルトはUSDで、サポートされている任意のシンボルを指定できます。EUR、GBP、JPYのほか、ビットコインや金で価値を表したい場合はBTCやXAUも使えます。クロスレートは同じスナップショットから計算されるため、常に互いに整合しています。

次のリクエストは、金1トロイオンスのユーロ建て価格であるEURXAUを返します：

GET /api/v1/latest?api_key=YOUR_API_KEY&base=EUR&currencies=XAU,XAG

質量単位

unitを指定しない限り、金属価格は1トロイオンス（31.1035 g）あたりの価格です。指定できる値は次のとおりです：

• troy_oz（デフォルト）、gram、kilogram、ounce（常衡オンス、28.35 g）、pound、metric_ton、short_ton

g、kg、lb、tonneなどの短縮形も使用できます。なお、ozは常衡オンスを意味します。地金の価格に使われるトロイオンスを指定するには、troy_ozを使うか、unitを省略してください。

unitは貴金属と産業用金属にのみ適用されます。エネルギーはバレル、MMBtu、ガロンあたりのまま変わらず、通貨と暗号資産にも影響しません。デフォルト以外の単位を使用すると、レスポンスにunitフィールドが含まれます。GET /api/v1/latest?base=EUR&currencies=XAU,XAG&unit=gramの場合：

{
  "success": true,
  "timestamp": 1792765800,
  "date": "2026-10-23",
  "base": "EUR",
  "unit": "gram",
  "rates": {
    "XAU": 0.009057444725,
    "EURXAU": 110.4064149,
    "XAG": 0.6713138244,
    "EURXAG": 1.489616277
  }
}

産業用金属とエネルギー

産業用金属（XCU銅、ALUアルミニウム、ZNC亜鉛、HRC熱延コイル鋼）は、他の金属と同様にデフォルトで1トロイオンスあたりの価格で提示されるため、すべての金属を直接比較できます。各市場で取引される単位で取得するには、銅はunit=pound、アルミニウムと亜鉛はunit=metric_ton、鋼はunit=short_tonを指定してください。

エネルギー価格は取引単位あたりの価格です。WTIとBRENTは1バレルあたり、NATURALGASは1 MMBtuあたり、GASOLINEとHEATINGOILは1ガロンあたりです。

GET /api/v1/latest?api_key=YOUR_API_KEY&currencies=XCU&unit=pound

サポートされているシンボル

• 貴金属： XAU金、XAG銀、XPTプラチナ、XPDパラジウム
• 産業用金属： XCU銅、ALUアルミニウム、ZNC亜鉛、HRC鋼
• エネルギー： WTI、BRENT、NATURALGAS、GASOLINE、HEATINGOIL
• 通貨： USD、EUR、GBP、JPY、CHF、CAD、AUD、CNY、INRを含む、約55のISO 4217通貨
• 暗号資産： BTC、ETH、SOL、XRP、BNB、ADA、DOGE、DOT、LINK、LTC、TRX、USDT、USDC

最新の完全な一覧はシンボルページに掲載されており、/api/v1/symbolsからも取得できます。

Bid価格とAsk価格

Standardプラン以上では、currencies内のシンボルに-BIDまたは-ASKを付けると、仲値に加えてBid価格とAsk価格を取得できます。これらは、インターバンクのフィードから提示されるシンボル（貴金属と主要通貨）で利用できます。currencies=XAU,XAU-BID,XAU-ASKの場合：

"rates": {
  "XAU": 0.0002501319446,
  "USDXAU": 3997.89,
  "XAU-BID": 0.0002501488386,
  "USDXAU-BID": 3997.62,
  "XAU-ASK": 0.0002501150529,
  "USDXAU-ASK": 3998.16
}

カラット別の金価格

/caratは、宝飾品向け純度（純度＝カラット÷24）の金価格を、任意の通貨と単位で返します。有料プランで利用できます。GET /api/v1/carat?carat=all&unit=gramの場合（抜粋）：

{
  "success": true,
  "carat": "all",
  "date": "2026-10-23",
  "base": "USD",
  "timestamp": 1792765800,
  "rates": {
    "XAU24K": { "price": 128.53515, "unit": "gram", "carat": "24", "purity": 1 },
    "XAU22K": { "price": 117.82389, "unit": "gram", "carat": "22", "purity": 0.916667 },
    "XAU18K": { "price": 96.401361, "unit": "gram", "carat": "18", "purity": 0.75 },
    "XAU14K": { "price": 74.978836, "unit": "gram", "carat": "14", "purity": 0.583333 }
  }
}

タイムスタンプと日付

timestampは、返された価格のUnix時刻（秒、UTC）です。dateは同じ日をUTCのYYYY-MM-DD形式で表したものです。過去データのレスポンスには、指定した日の00:00 UTCのタイムスタンプが付き、その日の終値が含まれます。

const date = new Date(data.timestamp * 1000);
console.log(date.toISOString()); // 2026-10-23T14:30:00.000Z

精度

レートは最大10桁の有効数字を持つJSONの数値で、0.0002501319446のような逆数レートにも十分な精度があります。丸めるのは値を表示するときだけにし、計算する前には丸めないでください。

市場の取引時間と週末

スポットの金属と通貨は、平日は24時間取引されています。市場はニューヨーク時間の金曜日17:00に閉まり、日曜日17:00に再開します。週末は価格が最後の相場で固定され、APIは金曜日の終値を返し続けます（シンボルページには「取引時間外」と表示されます）。

暗号資産は24時間365日取引されており、週末も更新され続けます。産業用金属とエネルギーは、それぞれの先物取引所の取引時間に従います。