公共 Swap API 即将关停：迁移 1inch 开发者门户实操指南

自 2023 年 8 月 11 日 11:30（CET）起，原有的公共 Swap API 将正式下线；尚未迁移的团队须立即订阅 1inch 开发者门户，方能继续无感知调用 DeFi 聚合服务。本文将手把手拆解迁移流程，手把手帮你避免业务中断。

为什么一定要迁移到 1inch 开发者门户？

公共 Swap API 退役的核心原因在于 产品层级升级：
过去的 api.1inch.io/v5.0 端点仅为试验性访问，缺乏负载均衡、SLA 与定制支持。而 1inch 开发者门户 已转为 机构级 SaaS 平台，带来三大价值：

• 稳定性：全球多节点部署，RPS 峰值提升 10 倍
• 合规性：企业订阅携带 SLA 与隐私政策，更易通过合规审计
• 扩展性：一次注册即可解锁 Swap、Spot Price、Orderbook 等 10 余种高频 API

不少团队担心切换后重新适配签名逻辑、链 ID 与返回格式——事实上，核心接口字段几乎不变，你只需要把域名从 api.1inch.io 换成 portal.1inch.dev/v5.2，其余代码可零改动热更新。👉 立刻验证迁移最小改动方案，拿测试网 100U Gas 薅羊毛

免费 vs 企业订阅，如何快速决策？

免费计划三步走

1. 使用 Google 或 GitHub 账号登录 1inch 开发者门户
2. 创建 Project，填入合约地址或应用名（可随意）
3. 复制生成的 Bearer Token，替换到现有 HTTP Header Authorization

整个过程不到 3 分钟，如果你只做行情展示或低频套利，免费配额已绰绰有余。

企业计划极速申请

我希望升级至可调阈值的高并发：

1. 在门户点击「Enterprise」，填表（组织/链/峰值 QPS）
2. 补发邮件至 [email protected]，附上项目 Docs 或 GitHub
3. 12 小时内收到专属对接人，协商 SLA 并签署电子合同

🔍 小贴士
若你的产品正在申请融资或持牌经营，把企业计划 SLA 纳入 Pitch Deck，可显著提升投资人信心。👉 查看真实案例：某交易所上线首月加 180 万用户，仅靠企业 API 三步走

8 大核心 API 详细速通

1. 1inch Swap API

功能：一键多路由比价
核心用例：DEX 聚合、跨链桥、打赏转账
必杀技：100+ 流动性来源 & split 参数可抑制滑点省钱

2. Spot Price API

功能：返回任意 token 的实时现货价
典型场景：链上钱包“总资产估算”
限制：仅支持 EVM 主网官方计价币

3. Balance API

功能：扫描钱包的 ERC-20、NFT、原生代币余额
场景：资产看板、清算机器人
优点：支持批量地址查询，减少 RPC 调用 90%

4. Token API

功能：模糊搜索 token 信息
场景：前端自动补全、CMC 替代搜索框
演示：输入 usdc 可返回多链 USDC 地址、小数位、logo 链接

5. Transaction Gateway API

功能：私有交易广播、抗 MEV
边缘案例：大额赎回不再触发三明治机器人
特色：eth_sendPrivateRawTransaction 私有广播路径仅需 1 行 HTTP 切换

6. Portfolio API

功能：追踪地址收益、PnL、手续费
数据来源：以太坊、Polygon、BNB Chain
输出：CSV、JSON 选其一，直连 BI 工具

7. Orderbook API

功能：限价单 + 聚合流动性
亮点：同一笔限价单可路由多家交易所挂单，最大化撮合概率
典型用例：CeFi 级界面滑点 < 0.1% 的链上 DEX

8. Gas Price API （即将发布）

功能：提供实时基础费 & 优先费建议
价值：让用户手续费从不“多给一分”

迁移 FAQ：团队最常问的 5 个问题

Q1：现有 SDK（如 web3-react-lib）还能用吗？
A：可以。SDK 来自公开包，引用的 baseURL 你只需改为 https://portal.1inch.dev/v5.2，无需修改方法签名。

Q2：有没有测试网水龙头或免 Gas 方式？
A：注册后在门户创建“Testnet Project”，即可获得 Goerli、Mumbai、Avalanche-Fuji RPC 资源和测试币水龙头直连，方便你本地 CI/CD。

Q3：免费 / 企业计划的账单是否自动计价？
A：免费计划无费用。企业按量计费，采用阶梯折扣，超出部分会提前邮件告警，月底邮件结算，支持 USDC、USDT、法币 SEPA。

Q4：旧 token 地址是否兼容？
A：兼容。所有 API 最多支持输入 0x 或域名形式的 token 地址，域名模式会自动解析为链上合约地址，保证向前兼容。

Q5：如果迁移后仍遇到 429 超时怎么办？
A：首先确认你没调用非 5.x 路径；其次增加请求之间的 delay，若多次触发 429，后台会自动弹回企业版义务支持。

10 分钟实战：Swap 接口迁移代码片段

假设你的项目依赖 axios 请求公共 API：

// 旧代码
const res = await axios.get(
  `https://api.1inch.io/v5.0/1/swap?fromTokenAddress=0x...&toTokenAddress=0x..&amount=...&fromAddress=...&slippage=1`
);

// 新代码（三步替换）
const token = process.env.ONEINCH_PRO_KEY; // 来自开发者门户
const res = await axios.get(
  `https://portal.1inch.dev/v5.2/1/swap`,
  {
    headers: { Authorization: `Bearer ${token}` },
    params: { fromTokenAddress, toTokenAddress, amount, fromAddress, slippage: 1 }
  }
);

仅需替换 url 与 header 即可完成迁移，无需改动签名和步长数。

立即行动
距离 API 下线已不足 24 小时：新建 Project、更新环境变量、验收回归测试。对任何链上应用而言，迁移到 1inch 开发者门户 不只是“六年技术债的终点”，更是 机构级 DeFi 基建的起点。别等 API 返回 410，才意识到流量中断的成本> 1000 倍订阅费。