跳转到正文

让兑换站汇率始终保持在 目标位置附近。

iEXRates 会采集 BestChange 报价，按你的规则计算最终汇率，跟踪竞争对手，发布 TXT 文件，并向操作员清楚说明为什么选择这个汇率。

该模块面向不只是“获取 BestChange 汇率”的兑换站，而是需要在大量方向上管理排名、利润、手续费、城市、排除项、公式和更新速度的业务。

价格—

  • 位置保护

    top-1、top-2、top-3 和指定竞争对手

  • 汇率公式

    标签、手续费、步长、取整和预览

  • TXT 文件

    每个配置一个独立文件

  • Go 核心

    快速更新大型列表

核心思路

这不是汇率表，而是 BestChange 市场控制中心

管理员配置配置文件、方向和规则。之后系统会自动更新字典、检查可用交易对、获取报价、应用公式、保护位置，并为兑换站网站准备公开文件。

方向与城市

现金方向中，城市会成为交易对和 TXT 代码的一部分，避免不同城市的汇率混在一起。

报价筛选

可纳入储备、限额、兑换站标记、黑名单、自有兑换站和零值报价。

兑换站跟踪

系统可跟随指定竞争对手，并自动位于其上方或下方。

可通过服务端分页和批量更新管理的方向
100k+
BestChange 与外部来源分开管理，集中在同一后台
2
实时更新状态、故障事件、日志和 TXT 新鲜度
24/7

包含内容

iEXRates 主要能力

BestChange 配置

统一设置语言、汇率类型、间隔、超时、默认位置、自有兑换站和 TXT 发布。

  • 共享 API URL 和镜像，支持 ping 与优先级
  • 密钥保存在数据库中，并从后台管理
  • 每个配置都有自己的 TXT 文件

工作示例

所有者如何配置一个方向

规则只需配置一次。之后 iEXRates 会获取市场、选择正确报价、应用保护，并发布最终汇率。

  1. 选择交易对

    例如 BTC 兑换现金 RUB，并要求城市为莫斯科。

  2. 设置目标

    第 #2 位、位于指定兑换站上方，或取 top-10 平均值。

  3. 应用规则

    筛选、储备、限额、黑名单、手续费、取整和防剧烈跳动。

  4. 发布 TXT

    类似 BTC-CASHRUB_MSK 的最终代码会写入配置文件，并可供网站使用。

公式

公式是系统内部的独立产品能力

公式编辑器会显示可用标签，解释每一步计算，并允许保存前检查结果。当汇率需要同时考虑多个条件时，这会非常实用。

规则示例

公式预览

[pos:3]
+ step_to_competitor
− 0.15%
位置
#3
竞争对手
兑换站

最佳汇率、指定位置、位置区间、多个位置平均值、自有兑换站或竞争对手。

跟踪与手续费

汇率可跟随指定兑换站，位于其上方或下方

每个方向都可选择目标兑换站、上方或下方模式、最小步长、变动限制、手续费，以及目标竞争对手从列表消失时的 fallback。

规则示例

参照对象
兑换站 · #3
动作
按步长位于上方
手续费
−0.15%

跟踪指定兑换站

方向不仅可以跟随排名，也可以跟随 BestChange 列表中的指定兑换站。

位于上方或下方

可将汇率设置为始终略高于指定竞争对手，或稳妥地位于其下方。

防跳动保护

变动限制和防跳动规则可避免汇率因偶发报价或临时市场错误而剧烈变化。

手续费与修正

汇率可使用 +1、-1、+1%、-1%、/5、/5% 或自定义公式，直接纳入利润和成本。

条件筛选

规则可考虑位置、储备、限额、兑换站标记、城市和黑名单。

可解释计算

Trace 会显示选中的报价、应用的步长、手续费触发点，以及最终值为何进入 TXT。

数据分析

看得见什么更新了、哪里延迟，以及汇率为什么变化

运营中心展示更新速度、TXT 新鲜度、队列健康状态、API 错误、计算历史和每个方向的质量。

更新速度

显示更新耗时、成功交易对、未更新方向和每秒处理速度。

历史与图表

可查看最终汇率、raw rate、位置、名次之间的 spread 和竞争对手行为。

故障事件

问题会变成清晰卡片：哪里失败，密钥、URL、方向和 TXT 发生了什么。

权限与访问

密钥登录、权限组、用户和审计日志帮助团队安全协作。

高速核心

更新按流水线执行，而不是一次重请求

Go 核心将工作拆成多个阶段：字典、方向检查、报价获取、计算、位置保护和文件生成。这样可降低延迟，并扩展到数千个交易对。

  1. dictionary.sync

    字典

    币种、城市、兑换站和标记在服务器上更新，并从本地存储读取。

  2. presence.scan

    方向检查

    系统可先检查哪些交易对真实存在，避免加载不必要的汇率。

  3. rates.fetch

    获取报价

    URL/key pool、限速、重试、快照缓存和 fallback 帮助应对 API 不稳定。

  4. rates.calculate

    汇率计算

    公式、位置、手续费、步长和限制共同生成一个可解释的最终汇率。

  5. guard.apply

    位置保护

    检查目标位置、竞争对手、最小步长和允许变动范围。

  6. txt.generate

    文件生成

    TXT 只在有变化时重建，保持发布速度。

额外来源

BestChange 仍是核心，但汇率也可扩展到外部来源

Binance、Bybit、WhiteBIT、Heleket、文件和手动汇率都可使用独立配置、自有代码、手续费、TXT 文件和服务端分页。

  • binance[binance_usdt-btc]
  • bybit[bybit_usdt-btc]
  • whitebit[whitebit_usdt-btc]
  • heleket[heleket_usdt-btc]
  • manual[manual_usdt-btc]

直接汇率、反向 1/汇率或自定义手续费

实用资料

做好接入准备

产品设置指南与帮助。

接入与设置

设置和接入 iEXExchanger 的操作指南。

打开指南

技术架构

iEXRates 基于什么构建

iEXRates 拆分为后台、API 和独立 Go 核心。后台不会直接调用 BestChange，而是使用 PostgreSQL、Redis 和日志中的预处理数据；汇率更新由服务端 worker 完成。

Frontend

操作员后台

React/Vite SPA，包含 i18n、TanStack Query、服务端表格、虚拟列表和实时运营页面。

  • React + TanStack Query

    请求缓存、无需刷新更新，以及稳定的页面状态

  • TanStack Table + Virtual

    面向数千行数据的分页、筛选和虚拟列表

  • Tailwind CSS + Vite

    快速构建和自适应后台界面

  • TypeScript strict

    表单、API 契约和界面状态的严格类型约束

Backend

API、Worker 与队列

NestJS 11 承载后台 API、公共 API、配置设置、访问控制、调度器、任务队列和后台事件。

  • NestJS 11

    面向配置、方向、日志、访问和来源的统一 API

  • PostgreSQL + Prisma ORM

    主数据库、严格模型和结构迁移

  • Redis

    热缓存、实时状态、锁和快速快照

  • ClickHouse

    高速日志、更新历史和事件分析

Infra

自托管部署

iEXRates 作为独立服务端产品部署：Go 核心、Docker Compose、Nginx、PostgreSQL、Redis、ClickHouse，以及公开 TXT 文件分发。

  • Go

    worker pool、批量更新、rate limit 和原子化文件生成

  • Docker Compose

    一次启动后台、API、engine、PostgreSQL、Redis、ClickHouse 和 Nginx

  • Nginx

    API 代理和公开 TXT 文件分发

  • Debian 12 / Ubuntu 22.04

    推荐的服务器安装基础系统

可用于兑换站

iEXRates 覆盖完整链路：从 BestChange 到网站可用汇率

配置会根据你的兑换站定制：配置文件、API 密钥、镜像、方向、公式、位置策略、TXT 文件、额外来源和更新分析。

仅限 iEXExchanger 客户

该项目需绑定有效的 iEXExchanger 授权，并作为核心平台的附加模块运行。

价格—