实时外汇数据 API 完整使用指南与接口文档

·

外汇交易离不开准确及时的数据支持。本文将详细介绍功能强大的实时外汇数据 API，涵盖从基础概念到高级功能的全面内容，帮助开发者快速上手并有效利用各类外汇数据接口。

什么是外汇数据 API？

外汇数据 API 是一种提供实时和历史外汇汇率数据的编程接口，支持多种货币对和技术指标。它汇集了全球 25 个以上实时数据源，覆盖 145 多个国家和 2000 多种外汇货币对，提供从 1 分钟到 1 个月不同时间间隔的技术指标和市场深度分析。

无论是寻找免费测试用的外汇 API，还是需要实时交易的最佳外汇 API，这套解决方案都能提供可靠准确的外汇数据，帮助用户获得更深入的交易洞察，包括关键技术指标和市场分析。

API 请求积分使用规则

大多数 API 端点的每个 URL 请求会计费 1 积分，但有 3 个端点按每返回 100 条记录计费 1 积分。基础计划允许用户每月在任何 API 上请求 10,000 次。

每个 API 请求通常计数 1 积分，但某些端点按响应计数，例如最新价格 API：

特殊规则：

快速入门指南

通过 API 免费获取实时外汇数据，在市场中保持领先。开发者可以使用任何编程语言与 API 交互，通过 PHP (Curl 或 file_get_contents)、JavaScript (Ajax)、Android (HttpURLConnection)、Java、C# (HttpWebRequest) 或 CURL 实现无缝集成。

所有 API 响应均采用 JSON 格式，便于顺畅处理数据。每个 API 端点具有独特功能，允许用户获取所有或特定货币的最新汇率。

API 访问密钥

需要访问密钥才能连接数据库。访问密钥是通过 API 基础 URL 中 access_key 参数传递的唯一密钥，用于验证 API 身份。

在查询字符串中传递 API 密钥：

https://fcsapi.com/api-v3/forex/选择的功能/?access_key=您的访问密钥

核心参数详解

参数详情
access_key (必需)必需参数。用于验证和授权请求的唯一访问密钥。有效值： API_KEY
type (可选)需要特定类型符号时使用：外汇/加密货币。默认： forex 有效值： forex, crypto
symbol (必需)注意： 至少需要 "id" 或 "symbol" 参数之一。默认： 无 有效值： 任何有效简称，all_forex
id (可选)获取所有外汇 ID 或符号列表使用下面的"列表 API"。有效值： 任何有效符号 ID
pair (可选)pair1 = EUR & pair2 = USD (同时使用两者)
from (可选)访问历史外汇 API 并查找特定日期历史数据时使用，需指定 from/to 日期之间的日期
to (可选)访问外汇历史 API 时必需与"From"参数一起使用
level (可选)需要在一个请求中获取更多历史蜡烛图时使用。默认： both 有效值： 1, 2, 3
amount (可选)设置转换价格。默认： 1
country (可选)任何有效国家。默认： 无
candle (可选)任何支持的蜡烛图值。默认： both 有效值： active, close, both
period (可选)少数端点 API 请求中必需，当请求蜡烛图价格、历史、信号、移动平均线、枢轴点时需要指定所需时间帧数据
time (可选)默认： 无 有效值： 1
output (可选)设置 API 响应格式。默认： json 有效值： json, jsonp, object, xml, serialize, array

支持的符号列表

可以使用以下 API 访问受支持的货币简称和符号的完整列表。这些符号将允许获取指标值、历史趋势和实时汇率。外汇 API 端点定期更新，确保始终拥有最新的实时外汇货币数据。

参数：

API：
返回所有符号，需要将这些符号用于最新价格 API、价格转换、历史数据和技术信号。

https://fcsapi.com/api-v3/forex/list?access_key=API_KEY

响应：
发送 API 请求后，将获得 JSON 响应，可根据需要更改。响应使用关键索引键（如 id、name、symbol 和 decimal）进行组织，映射到流行货币。可根据具体需求利用这些数据。

响应包含状态、代码、消息和响应数组，其中包括分配给符号的 ID、全名、符号名称和价格总小数位数。信息数组包含服务器时间和 API 总积分计数。

👉 查看实时外汇符号列表工具

外汇货币简档详情

在 API 中可以获取有关外汇货币的所有详细信息，包括其名称、国家名称、银行名称、货币单位、纸币类型等更多详细信息。

请求积分使用： 每返回 100 条记录计费 1 积分（向上取整）。

参数：

支持通过 ID、符号组合或货币简称进行请求，返回包括简称、名称、国家、代码、子单位、网站、符号、银行、纸币、硬币、图标和类型等详细信息。

货币转换器 API

货币 API 中的价格转换是一项基本功能，使您能够在两种选定货币之间进行兑换。只需包含符号参数以及要转换的金额即可实现。货币兑换 API 确保无缝高效的转换过程。

注意： 以下 API 不支持在 URL 中作为参数使用多个符号名称。每次请求仅发送一个符号名称。

参数：

响应包含价格转换比例和总额计算，以及服务器时间和积分计数信息。

货币最新价格 API

最新货币汇率 API 非常有益，确保您随时了解最新货币价格。货币转换 API 使您能够一次检索一个或多个货币汇率。只需发送带有符号参数的请求，将其分配给一个或多个逗号分隔的货币代码。

注意： 每 30 秒或更短时间内更新每种货币的价格。如果需要时间帧最新价格（如 5m、1h、1week 蜡烛图价格），请使用最后蜡烛图 API。

请求积分使用： 每返回 100 条记录计费 1 积分（向上取整）。

参数：

支持通过单个或多个 ID、单个或多个符号以及所有外汇货币一次性请求所有价格。

响应包含分配给符号的 ID、市场开盘价、最高价、最低价、收盘价/当前价、变化价格、变化百分比、最后更新时间（Unix 格式和 UTC 时间）以及符号名称。

最新蜡烛图价格（支持时间帧）

提供货币的最后蜡烛图价格，这是 API 的重要功能。可以同时访问单个或多个蜡烛图价格。要获取蜡烛图 OHLC 价格，只需在 URL 请求中包含符号参数并指定一个或多个逗号分隔的货币代码。

注意： 最后外汇蜡烛图 API 仅支持外汇列表中的有效 ID 或名称，且蜡烛图 API 的准确性低于历史数据和最新 API。

请求积分使用： 每返回 100 条记录计费 1 积分（向上取整）。

参数：

响应包括分配给符号的 ID、开盘价、最高价、最低价、收盘价/当前价、询价、出价、点差、最后更新时间（Unix 格式）、变化价格、变化百分比、符号名称、最后更新时间（UTC）和最后更新价格。

常见问题

如何获取 API 访问密钥？

API 访问密钥需要在相应平台注册账户后生成。每个账户有唯一的访问密钥，用于验证所有 API 请求的身份和权限。密钥应妥善保管，避免泄露。

实时数据更新的频率是多少？

大多数货币对的实时数据每 30 秒或更短时间更新一次。对于需要更高频率更新的交易场景，建议使用专门的高频数据接口或考虑升级到更高级别的API服务套餐。

历史数据可以追溯到什么时间？

对于大多数符号，历史价格可从 1995 年开始提供，具有 1 天或更高时间帧的数据。还可以访问 1 分钟、5 分钟和其他短期数据，最长可达 6 个月。不同货币对的历史数据深度可能有所不同。

👉 获取进阶历史数据分析方法

API 请求有哪些限制？

基础计划允许每月 10,000 次请求，不同端点有不同计费方式。大多数端点每个请求计费 1 积分，但最新价格、蜡烛图和简档 API 按每返回 100 条记录计费 1 积分。建议监控使用情况以避免超额。

如何处理 API 错误响应？

API 错误响应通常包含状态代码、错误消息和详细信息。常见错误包括无效参数、超出限额或身份验证问题。应检查错误响应中的具体信息并相应调整请求参数或联系支持。

是否支持 WebSocket 实时数据？

本文档介绍的 API 主要基于 RESTful 架构，对于需要极低延迟的实时数据需求，建议查阅平台的 WebSocket 文档或考虑使用专门的高频数据服务解决方案。

外汇历史价格 API

如果想要比较当前汇率与过去汇率以观察市场趋势，外汇历史 API 提供所有支持符号的全面历史汇率数据。只需将日期（YYYY-MM-DD 格式）附加到 API URL 并使用 period 参数与选项（如 {1m, 5m, 30m, 1h, 2h, 4h, 5h, 1d, 1w, month}）即可检索历史汇率。

参数：

注意： 以下 API 不支持在 URL 中作为参数使用多个 ID。每次请求只能发送一个 ID 或符号名称。且 2h、4h 在 1 个请求中最多返回 300 个蜡烛图。

请求积分使用： 每返回 300 个蜡烛图计费 1 积分（向上取整）。

提供简单易用的最新历史 API，返回前 900 个蜡烛图，这是最新且易于观察市场的最新数据。使用"Level"参数控制蜡烛图数量：level=1 返回 300 个蜡烛图，level=2 返回 600 个蜡烛图，level=3 返回 900 个蜡烛图。

市场趋势/信号 API

在外汇市场中，取决于投资者如何分析先前和当前市场趋势，然后进行外汇投资并实现盈利入场。市场趋势/信号 API 专为那些想知道市场趋势或想要开发外汇指标的人开发。指标或多头/空头信号基于特定时间期内先前的 300 个蜡烛图计算。

包括外汇枢轴点 API、外汇移动平均线 API（MA 线）和外汇技术指标 API，提供关键的支撑/阻力水平、趋势评估和市场信号。

经济日历 API

获取实时指标，了解经济事件宣布后的即时影响全球市场的情况，包括过去、预测和实际数据。

请求积分使用： 每返回 50 个事件计费 1 积分（向上取整）。

参数：

搜索 API

此 API 类似于网站搜索。可以搜索所有具有相似名称的货币。将在货币全名和短名中搜索。响应返回最多 20 个结果。

参数：

多URL同时请求

当需要同时访问多个 API 端点时，可能耗时较长。可以编写自定义代码发送并行 API 请求，或简单地使用此 API 获得更快解决方案。例如，如果调用 10 个 API，每个耗时 2 秒，则总共需要 10 x 2 = 20 秒。此 API 旨在解决这种时间延迟问题，可以在短短 2 秒内检索所有 10 个结果！

参数：

免责声明

价格、市场趋势和信号并非为交易目的而设计，这些信号仅用于教育或非商业用途。此应用程序/网站中包含的数据不一定是实时或准确的，因此价格可能不准确，可能与实际市场价格不同，意味着价格是指示性的，不适用于交易目的。因此，我们不承担因使用此数据而可能产生的任何交易损失的责任。

最新价格最低刷新率为 5 秒。

通过本指南，您应该已经了解了如何充分利用外汇数据 API 的各项功能。无论是实时数据获取、历史分析还是技术指标计算，这些接口都能为您的交易决策和系统开发提供坚实的数据支持。记得始终遵循最佳实践，合理管理API请求频率，并充分利用平台提供的各种工具和资源。