使用 1inch 投资组合 API 一站式管理 Web3 资产

·

核心关键词：1inch 投资组合 API、Web3 资产管理、DeFi 收益追踪、多链钱包、LP 仓位分析、加密资产隐私保护、API 对接示例、PnL 计算

在碎片化的多链时代，个人投资者往往需要同时管理数十条网络、上百种代币与错综复杂的 DeFi 头寸。1inch 推出的 Portfolio Service API（下文简称“API”）把这一繁琐过程自动化：只需几行代码，即可实时读取多钱包、多链资产总价值、盈亏、收益率与日级别细节。本文从功能亮点到对接步骤全面拆解，带你快速上车。

一、功能亮点速览

  1. 一揽子追踪：支持 Ethereum、BSC、Polygon、Arbitrum 等主流链。
  2. 细粒度数据：返回总市值、PnL、ROI、代币快照、历史收益曲线。
  3. DeFi 透视：Uniswap V3、Lido、Aave、Curve 协议 LP 盈亏一键解析。
  4. 零数据泄露：本地签名查询，服务器仅返回加密结果，用户始终托管私钥。

👉 如何通过零代码体验该 API 的实时资产估值效果？

二、实战对接：三步拿到第一份资产报告

2.1 获取 API 密钥

前往 1inch DevPortal 注册账号，创建 App 即得 API_KEY，免费层 1 QPS、每月 1 万次调用。

2.2 环境准备

npm init -y
npm install dotenv

.env 中写入：

API_KEY=粘贴你的密钥
WALLET_ADDRESS=粘贴你的钱包地址
CHAIN_ID=1  # 以太坊主网示例

2.3 编写核心函数

require("dotenv").config();
const delay = (ms) => new Promise((r) => setTimeout(r, ms));

async function request(endpoint) {
  return fetch(endpoint, {
    headers: { Authorization: `Bearer ${process.env.API_KEY}` }
  }).then((r) => r.json());
}

// 资产当前价值
async function getCurrentValue() {
  const url = `https://api.1inch.dev/portfolio/portfolio/v4/overview/erc20/current_value?addresses=${process.env.WALLET_ADDRESS}&chain_id=${process.env.CHAIN_ID}`;
  return request(url);
}

// 历史盈亏
async function getPnL(from, to) {
  const url = `https://api.1inch.dev/portfolio/portfolio/v4/overview/erc20/profit_and_loss?addresses=${process.env.WALLET_ADDRESS}&chain_id=${process.env.CHAIN_ID}&from_timestamp=${from}&to_timestamp=${to}`;
  return request(url);
}

// 代币详情
async function getTokenDetails() {
  const url = `https://api.1inch.dev/portfolio/portfolio/v4/overview/erc20/details?addresses=${process.env.WALLET_ADDRESS}&chain_id=${process.env.CHAIN_ID}`;
  return request(url);
}

2.4 运行脚本

(async () => {
  console.log("Current Value:", await getCurrentValue());
  await delay(2000);
  console.log("PnL:", await getPnL("2023-01-01T00:00:00Z", "2023-12-31T23:59:59Z"));
  await delay(2000);
  console.log("Details:", await getTokenDetails());
})();

执行 node index.js，控制台即可输出 JSON 格式的完整资产报告。

👉 想直接调用云端沙箱测试？点这里立即体验！

三、高频使用场景深度解析

3.1 DeFi 收益仪表盘

结合前端框架（Nuxtjs、Nextjs）可 15 分钟内搭建个人资产管理仪表盘。通过轮询 API 获取每日 profit_and_loss，把收益率可视化呈现，给自己和 LP 投资者公开透明的实时报告。

3.2 多签钱包监控

机构用户可把多签成员钱包一次性加入查询参数，脚本每日早 8 点自动 PDF 报告邮件推送风控与合规团队。

3.3 LP 亚健康预警

Uniswap V3 NFT 值跌到一定阈值触发 Webhook，调用 API 计算 LP 在集中流动性区间的 impermanent_loss，在 Discord 频道发布提醒。

四、FAQ：最容易踩的六个坑

Q1：是否可以只追踪特定代币而非整个钱包？
A：可在请求中加 tokens 参数传入合约地址数组，数据结构保持不变，返回仅含这些代币的资产面板。

Q2：免费层 QPS 太低怎么办？
A：升级到 Pro 层即可提升至 10 QPS，满足大部分企业级监控需求。

Q3：为什么某些新发行小币没有价格？
A：API 源于 1inch 聚合器的路由数据，未进入主路由的小币种需等待流动性增加后才会被收录。

Q4：API 返回字段中的 usdPrice 是每分钟更新吗？
A：价格取自链上预言机与中心化交易所加权平均，1 分钟内波动超过 0.5% 即同步。

Q5：可以查询 NFT 仓位吗？
A：目前仅支持 ERC-20 与部分 LP Token，NFT 功能在 2025Q3 测试网中，可关注官方 Roadmap 及时跟进。

Q6：数据隐私如何真正做到“无第三方介入”？
A：所有签名仅用于钱包地址验证，服务器不存储私钥或助记词；返回数据通过一次性 TLS 加密通道下载，30 秒后本地缓存自动失效。

五、结语：下一步

掌握 1inch 投资组合 API，你就拥有了自动化洞察多链资产表现的核心武器。下一步可以尝试：

愿你在 Web3 世界轻松掌控每一分钱，安心抓住每一次 Alpha。