Iran Crypto Exchanges

面向 AI Agent

• 简介： 用于获取伊朗 7 家加密货币交易所（Nobitex、Wallex、Bitpin、Ramzinex、Tabdeal、OMPFinex、Exir）公开市场数据的非官方 MCP 服务。
• 安装： uvx iran-crypto-mcp 或 claude mcp add iran-crypto -- uvx iran-crypto-mcp。传输方式：stdio。需要 uv（Python 3.10+）。
• 身份验证： 无需 API 密钥或账户。可选配置 IRAN_CRYPTO_MCP_PROXY（HTTP 代理 URL，或以逗号分隔的列表）；系统代理设置将被忽略。
• 访问权限： 只读。无需登录，也不涉及余额、订单或交易，因此调用任何工具前都无需确认。
• 工具： 共 8 个，名称均以 ic_ 开头。可从 ic_compare_price 开始。典型调用顺序：ic_compare_price -> ic_get_orderbook -> ic_candles。
• 适用场景： 比较某个币种在伊朗各交易所的价格、查看价差、读取订单簿或近期交易，或列出 24 小时涨跌幅领先的币种。
• 不适用场景： 用户想要买入、卖出或转账，需要账户数据，或想查询非伊朗交易所时。
• 输出： 精简 JSON。所有 IRT 价格均以托曼为单位（字段名为 *_toman）；USDT 市场的字段名为 *_usdt。
• 机器可读信息： server.json 和 awesome-iran-mcp 目录。

原因

• 里亚尔与托曼。 Nobitex、Ramzinex 和 OMPFinex 发布里亚尔价格；Wallex、Bitpin、Tabdeal 和 Exir 发布托曼价格。同一 BTC 的价格在不同交易所之间相差 10 倍。本服务会将所有价格转换为托曼，方便直接比较。
• 手动查询七个网站。 每家交易所都有自己的应用、交易对名称和 API 格式。调用一次 ic_compare_price，即可按价格从低到高查看各家交易所的该币种价格及价差。
• 波斯语名称。 每一行交易所数据都包含 name_fa，即该交易所自己的波斯语名称，因此用波斯语回答时无需依赖模型拼写名称。

功能

• 比较七家交易所中某种币的价格，支持土曼或 USDT 报价，按价格从低到高排列，并显示价差
• 获取行情：交易所提供时，包含最新价格、24 小时价格区间和涨跌幅、交易量以及最佳买价／卖价
• 查看订单簿（每侧最多 20 档）和近期公开成交
• 获取 Nobitex 和 Wallex 的 OHLC 蜡烛图（15m、1h、4h、1d）
• 排名某家交易所中 24 小时涨幅最大和跌幅最大的币种，并过滤流动性低的币种
• 列出交易所以土曼或 USDT 为交易对的币种

示例提示词：

• “用土曼比较所有伊朗交易所的 BTC 价格。哪里最便宜？”
• “现在每家交易所的泰达币（USDT）土曼汇率是多少？”
• “显示 Nobitex 的 ETH 订单簿。价差是真的吗？”
• “过去 24 小时 Wallex 涨幅最大的 5 种币。”
• “给我 Wallex 过去两天的 BTC 1 小时蜡烛图。”
• قیمت بیت‌کوین را در همه صرافی‌های ایرانی به تومان مقایسه کن.
• قیمت تتر الان در کدام صرافی ارزان‌تر است؟
• دفتر سفارش اتریوم در نوبیتکس را نشان بده.

支持的交易所

• 七家交易所都支持热门币种排名和两种报价货币：土曼（IRT）和 USDT。USDT 市场始终以 USDT 报价。
• “完整”表示包含最新价格、买价、卖价、24 小时最高价和最低价、涨跌幅及交易量。
• Bitpin 的交易量通过尽力而为的第二次调用获取；如果调用失败，行情中将不含交易量。
• Exir 仅公布基础货币交易量，因此报价货币交易量按交易量乘以最新价格估算。
• 当行情中没有最佳买价和卖价时，使用 ic_get_orderbook 获取。
• Nobitex 拒绝提供 USDT/IRT 蜡烛图（其 CDN 返回 HTTP 403，浏览器也不例外）：请改用 Wallex。

快速开始

你需要安装 uv。无需 API 密钥或账户。

claude mcp add iran-crypto -- uvx iran-crypto-mcp

{
  "mcpServers": {
    "iran-crypto": { "command": "uvx", "args": ["iran-crypto-mcp"] }
  }
}

{
  "servers": {
    "iran-crypto": { "type": "stdio", "command": "uvx", "args": ["iran-crypto-mcp"] }
  }
}

codex mcp add iran-crypto -- uvx iran-crypto-mcp

[mcp_servers.iran-crypto]
command = "uvx"
args = ["iran-crypto-mcp"]

gemini mcp add iran-crypto uvx iran-crypto-mcp

这 8 个工具均为只读。交易所 ID：nobitex、wallex、bitpin、ramzinex、tabdeal、ompfinex、exir。quote 为 IRT（土曼，默认）或 USDT。

工作原理

  AI agent  (Claude, Cursor, Copilot, ...)
      │
      │  MCP over stdio
      ▼
  iran-crypto-mcp  (runs on your machine)
      │
      │  HTTPS
      └──────▶  public market-data endpoints of the 7 exchanges

• 在本地运行，并调用交易所自有网站使用的公共端点。没有托管服务作为中间环节，也不需要 API 密钥。
• 使用类似 Chrome 的 HTTP 客户端，并像各交易所网站一样发送其各自的 Origin 和 Referer。
• 答案缓存 15 秒，且最多同时运行 2 个请求。失败的 GET 请求会重试。
• 只读：绝不会调用账户、订单或交易端点。

须知

• 单位已统一。 IRT 价格以土曼计（里亚尔交易所的价格除以 10）；USDT 价格保持不变。单位体现在字段名中：price_toman、price_usdt。
• 每个交易所数据行中的 name_fa 都是该交易所自己的波斯语名称。
• 单个交易所可能单独失败。 ic_compare_price 会在 errors 下报告失败的交易所，同时继续比较其他交易所。HTTP 403 表示该交易所的 CDN 拒绝了你的网络请求。设置 IRAN_CRYPTO_MCP_PROXY 为伊朗 HTTP 代理后重试。
• 价差未必真实。 报价存在差异可能有实际原因（手续费、流动性、滞后的最新成交价）。采取行动前，请检查两家交易所的订单簿。
• 回复大小有限制，以控制在约 15 KB 以内：订单簿 20 档、交易记录 50 条、蜡烛图 100 条、涨跌幅榜 25 条。
• 涨跌幅榜会跳过 24 小时交易量低于门槛的币种（默认 100,000,000 土曼或 10,000 USDT；设置 min_volume 可更改）。Tabdeal 不公布交易量，因此不会过滤其币种。
• 价格仅供参考。 价格接近实时（缓存 15 秒），并非可供交易的报价。

常见问题

配置

波斯语

claude mcp add iran-crypto -- uvx iran-crypto-mcp

开发

git clone https://github.com/sepehr071/iran-crypto-mcp && cd iran-crypto-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q          # offline unit tests
uv run python -m pytest -m live -q  # calls the real exchange APIs
uv build

工具位于 src/iran_crypto_mcp/markets.py，各交易所的适配器位于 exchanges.py。欢迎提交问题和 PR。 发布版本：在 pyproject.toml 和 server.json 中更新版本，然后推送一个 v* 标签。

相关服务

• awesome-iran-mcp：所有伊朗服务 MCP 服务的目录
• tgju-mcp：获取 TGJU 的美元、黄金、金币和大宗商品价格
• tsetmc-mcp：获取德黑兰证券交易所信息
• milligold-mcp：获取黄金价格
• iran-news-mcp：获取伊朗新闻

免责声明

本项目为非官方项目，与任何交易所均无关联，也未获其认可。它仅读取公开市场数据：无需密钥或账户访问，也不支持交易。价格仅供参考，不构成财务建议；接口可能随时变更，恕不另行通知。

作者

由 Sepehr Radmard（سپهر رادمرد）开发和维护。欢迎在 LinkedIn 上联系，或在 GitHub 关注 @sepehr071，了解更多面向伊朗网站的 MCP 服务；所有服务均列于 awesome-iran-mcp。如果这个项目为您节省了时间，请给仓库点个 Star，帮助其他人发现它。

许可证

MIT