EMpulse Street FX Index API
新兴市场货币的每日街头汇率，以每 1 USDT 对应的法币金额报价（USDT 按 1 USD 计）：即人们实际支付的汇率，而非官方汇率。每个序列都带有置信度等级。完整方法见方法论。
指数行的字段
| 字段 | 含义 | 为 null 的情况 | 套餐 |
|---|---|---|---|
buy | 当日客户用法币买入 USDT 的加权平均汇率。 | 当日买入方向的数据点过少。 | 所有套餐 |
sell | 客户卖出 USDT 一侧的同类汇率。 | 当日卖出方向的数据点过少。 | 所有套餐 |
mid | 两个方向都有数据时为 (buy + sell) / 2；只有一个方向时，取该方向的汇率。 | 两个方向的数据点均不足。 | 所有套餐 |
side | 中间价由哪些方向构成：both、buy 或 sell。仅由单一方向得出的中间价，相对于双向中间价约偏移半个价差。 | 没有中间价。 | 所有套餐 |
spread_pct | (buy − sell) / mid × 100。 | 方向不是 both。 | 所有套餐 |
confidence | high、medium 或 limited：根据覆盖情况确定的该货币等级；数据点少于往常的一天降低一级。limited 表示来源或数据点较少，噪声更大，可能存在缺口。 | 从不。 | 所有套餐 |
flag | outlier：数据点较少的一天，其中间价与前后 ±15 天中间价的中位数相差超过 10%。该日保留其数值，但不计入 mid_7d 和 chg_* 字段。 | 该日不是异常值。 | 所有套餐 |
in_progress | true：某货币的最新一天仍在采集中，且其数据点明显低于前 7 天的常态水平。 | 从不。 | 所有套餐 |
mid_7d | 最近 7 个日历日（含当日）内有效中间价的平均值。 | 窗口内没有有效中间价。 | 所有套餐 |
chg_1d_pct | 中间价相对于恰好 1 个日历日前的变化，以百分比表示。 | 两天中任一天没有有效中间价。 | 所有套餐 |
chg_7d_pct | 中间价相对于恰好 7 个日历日前的变化，以百分比表示。 | 两天中任一天没有有效中间价。 | 所有套餐 |
chg_30d_pct | 中间价相对于恰好 30 个日历日前的变化，以百分比表示。 | 两天中任一天没有有效中间价。 | 所有套餐 |
exchange_spread_pct | 当日报价该货币的各交易所之间的差距：(最高 − 最低的交易所中间价) / 中位数 × 100。价差扩大是 FX Stress Signals 的输入之一。 | 报价该货币的交易所少于两家，或密钥为免费密钥。 | Pro、Enterprise |
日期为 UTC 日历日。最新一天在结束前并不完整，可能被修订；最近 15 天的标记可能随新数据的到来而变化。
小时汇率（Pro 和 Enterprise）。 GET /v1/rates/CUR/hourly?from=&to= 按 UTC 小时返回指数（每次请求最多 31 天），/v1/rates/CUR/hourly/latest 返回某个序列最近 24 小时的数据，/v1/rates/hourly/latest 返回每种货币最近一个完整小时的数据。小时行带有相同的 buy、sell、mid、side、spread_pct、confidence 和 in_progress；按货币返回的响应会按天增加 summary。免费密钥会收到 403 tier_not_in_plan。
多来源街头指数。 /v1/street-index/*：汇总众多独立公开市场来源的街头汇率，附置信度评分，覆盖这些来源所涉及的每种货币（同一密钥）。
请在 X-API-Key 请求头中发送您的密钥。Free:仅限 RUB, UAH, EGP,每日 100 次请求,数据截至最近一个完整日。Pro:所有币种,每日 10,000 次请求,包含当日(进行中)数据。Enterprise:按合同约定。限额于 UTC 00:00 重置。
默认返回 JSON;发送 Accept: text/csv 或添加 ?format=csv 可获得 CSV。错误以 JSON 返回,其中 error 对象包含 code 和 message,状态码为 400(参数错误)、401(缺少密钥或密钥无效)、403(时间段、币种或产品不在当前套餐内:tier_delay、currency_not_in_plan、tier_not_in_plan、key_frozen)、404(未知币种或路由)、429(rate_limit_exceeded、history_quota_exceeded)或 503。
早于 90 天的数据行计入每个密钥的每日配额(free 1,000 行,pro 3,000 行,按 UTC 日计);完整导出需签订 Enterprise 协议。密钥仅限个人使用;自动批量下载将导致密钥被冻结。请参阅条款。
街头汇率不是官方汇率或银行间汇率;confidence 为 limited 的序列可能存在噪声和数据缺口。这些数据不构成投资建议。