Twelve Data/GetCurrencyConversion

Twelve DataTwelve Data 外汇 API

GET/currency_conversion

换算货币金额

按指定外汇货币对换算一个金额。

查询外汇实时与历史市场数据、货币换算、参考信息和技术指标；调用方以自己的 Twelve Data 凭据直连服务。

请求

operationId: GetCurrencyConversion
服务器: https://api.twelvedata.com
认证: apiKey

请求参数

`symbol`

querystring必填

外汇货币对，使用 BASE/QUOTE 格式，例如 EUR/USD。

EUR/USD

`amount`

querynumberdouble必填

需要换算的金额。

1.2345

`date`

querystring

用于查询或换算的日期。

2025-01-02

`format`

queryFormatEnum

`delimiter`

querystring

delimiter 字段。

delimiter-sample

`dp`

queryintegerint64

dp 字段。

`timezone`

querystring

输出时间使用的时区。

UTC

响应

`200`

GetCurrencyConversion_200_responseapplication/json

请求成功，返回该 Endpoint 定义的 JSON 数据。

字段: amountratesymboltimestamp

`400`

ApiBadRequestErrorResponseBodyapplication/json

请求参数无效。

字段: codemessagestatus

`401`

ApiUnauthorizedErrorResponseBodyapplication/json

调用方凭据无效或缺失。

字段: codemessagestatus

`403`

ApiForbiddenErrorResponseBodyapplication/json

调用方套餐或权限不允许此请求。

字段: codemessagestatus

`404`

ApiNotFoundErrorResponseBodyapplication/json

请求的资源或数据不存在。

字段: codemessagestatus

`414`

ApiParameterTooLongErrorResponseBodyapplication/json

请求参数超过服务允许的长度。

字段: codemessagestatus

`429`

ApiTooManyRequestsErrorResponseBodyapplication/json

调用方超过服务速率或额度限制。

字段: codemessagestatus

`500`

ApiInternalServerErrorResponseBodyapplication/json

上游服务未能完成请求。

字段: codemessagestatus

{
  "amount": 1.2345,
  "rate": 1.2345,
  "symbol": "EUR/USD",
  "timestamp": 1
}