Iran Exchange Rate & Gold Price API

Iran exchange rate API for free-market USD, EUR, GBP and 140+ FX pairs plus Iranian gold coins, 18K gold/gram and silver. Live panel, multi-period returns, OHLC history and day summaries in clean English JSON

原始信息汇总

数据集概述：伊朗汇率与黄金价格 API

基本信息

• 提供方: EconPulse
• 订阅用户数: 5
• 类别: 金融
• 地址: https://rapidapi.com/siavashmoh/api/iran-exchange-rate-gold-price-api

数据内容

该API提供伊朗自由市场的汇率和贵金属实时及历史数据，覆盖以下范围：

• 外汇: 140+ 货币对，包括美元（USD/IRR自由市场）、欧元、英镑、土耳其里拉、阿联酋迪拉姆等。
• 黄金: 伊朗金币（如 Emami 金币、Bahar Azadi 金币、半金币、四分之一金币）、18K 金/克、金衡盎司（ons）、Mesghal 单位。
• 白银: 白银价格参考。
• 返回纯净的英文字段JSON格式数据。

可用端点与功能

端点	功能	说明
GET /iran_market/symbols	获取所有可用交易代码	返回外汇、黄金、白银的英文代码及名称列表
GET /iran_market/panel	获取实时行情与多周期回报	根据代码列表，返回实时价格、Jalali日期及日、周、月、年、年初至今、5年、10年回报率
GET /iran_market/panel/all	获取全市场实时面板（Ultra及以上计划）	一次性返回所有注册代码的实时行情与回报
GET /iran_market/history	获取日级别OHLC历史数据	支持指定代码、日期范围，返回开盘、最高、最低、收盘价，适用于K线图研究
GET /iran_market/day-summary	获取日内日度摘要	返回当日开盘/最高/最低/当前价、与昨日收盘的百分比变化及采样日内序列
GET /iran_market/return	获取指定时期的价格回报	输入代码和起止日期，返回起止价格、绝对变化及回报百分比

订阅计划与限制

计划	月费	面板代码数/次	全市场面板	历史数据行数/次	历史数据行数/天
Basic (免费)	$0.00	1	否	100	100
Pro	$29.99	20	否	5,000	5,000
Ultra (企业级)	$59.99	无限制	是	20,000	无限制

• 超出配额返回 HTTP 429，超出面板代码数返回 HTTP 403。
• 每次响应均包含 meta 信息（计划、限制等）。

认证方法

• 在每个请求中需提供以下标头：
  • X-RapidAPI-Key：您的RapidAPI应用密钥
  • X-RapidAPI-Host：该API的RapidAPI主机地址
  • X-RapidAPI-Subscription：计划名称（basic、pro、ultra）

常见错误代码

HTTP状态码	含义
400	缺少或无效的代码参数
403	超出计划限制（面板代码数或无权访问/panel/all）
404	无对应代码的实时或历史数据
429	当日历史数据行配额超限

建议用例

1. 伊朗汇率仪表盘：通过 /panel 获取 price_dollar_rl（美元自由市场）、price_eur（欧元）、sekee（Emami金币）的实时价格与多周期回报。
2. USD/IRR 研究：通过 /history 获取美元/伊朗里亚尔的日OHLC数据用于图表分析。
3. 黄金/外汇小部件：通过 /day-summary 获取18K金或主要货币的当日涨跌概览。