cotizacion-dolar-argentina

アルゼンチン・ドル相場

DolarAPI を使って、アルゼンチンのドルと通貨の為替レートを確認します。

API の概要

• ベース URL：https://dolarapi.com
• 認証：不要
• レスポンス形式：JSON
• データソース：DolarAPI の公開エンドポイント
• タイムスタンプ：fechaActualizacion は ISO UTC 形式です。例：2026-02-17T13:59:00.000Z

エンドポイント

ドル（一覧およびタイプ別）

• GET /v1/dolares
• GET /v1/dolares/{tipoCotizacion}

{tipoCotizacion} で指定できる値：

• oficial
• blue
• bolsa
• contadoconliqui
• tarjeta
• mayorista
• cripto

例：

curl -s https://dolarapi.com/v1/dolares | jq '.'
curl -s https://dolarapi.com/v1/dolares/blue | jq '.'

その他の通貨

• GET /v1/cotizaciones
• GET /v1/cotizaciones/{codigoMoneda}

{codigoMoneda} で指定できる値：

• eur
• brl
• clp
• uyu

例：

curl -s https://dolarapi.com/v1/cotizaciones | jq '.'
curl -s https://dolarapi.com/v1/cotizaciones/eur | jq '.'

指定できる値

• tipoCotizacion：oficial、blue、bolsa、contadoconliqui、tarjeta、mayorista、cripto
• codigoMoneda：eur、brl、clp、uyu

ユーザーの表現に対応するマッピング：

• 「MEP」→ bolsa
• 「CCL」または「contado con liqui」→ contadoconliqui

主なフィールド

レスポンスの基本フィールド：

• moneda
• casa
• nombre
• compra
• venta
• fechaActualizacion

確認されている任意フィールド：

• variacion（mayorista など、一部のケースで表示されることがあります）

ワークフロー

1. ユーザーの意図を特定します：
   • 一般的なドル、または特定のタイプ
   • その他の通貨（eur、brl、clp、uyu）
2. 意図に応じて適切なエンドポイントを選択します。
3. 指定された値（tipoCotizacion または codigoMoneda）を検証します。
4. curl -s でリクエストを実行し、jq で解析します。
5. まず簡潔な概要を示し、その後に詳細を提示します。
6. レスポンスには必ず fechaActualizacion を含めます。
7. 複数の為替レートがある場合は、casa ごとに比較して提示します。

エラー処理

• 404 でボディが空の場合：
  • tipoCotizacion または codigoMoneda が存在しない場合に発生します。
  • 「サポートされていないタイプです」または「サポートされていない通貨です」と明確に伝えます。
• ネットワーク障害／タイムアウト：
  • 短い間隔を置いて、最大 2 回再試行します。
  • 再度失敗した場合は、問い合わせたエンドポイントとエラーを返します。
• 予期しない JSON：
  • 役立つ内容を最小限そのまま表示し、データソースに不整合があることを明記します。

結果の提示

• compra、venta、およびスプレッド（venta - compra）を優先して提示します。
• ドルの表示順は次のとおりです：
  • oficial、blue、bolsa、contadoconliqui、mayorista、cripto、tarjeta
• タイムスタンプのタイムゾーン（データソースでは UTC）を明記します。
• 金融上の推奨は行わず、為替レートの情報のみを提供します。

対象外

このスキルでは、v1 で以下を使用してはいけません：

• /v1/ambito/dolares*
• /v1/estado
• 他の国のエンドポイント