内容
# @usenami/funding-mcp
MCP 服务器，用于 **多场馆永续 + HIP-3 市场数据** — 20+ 交易所，包括 Binance、Bybit、OKX、Hyperliquid、Aster、Lighter，以及 **Hyperliquid HIP-3 子 DEX** （股票、金属、石油、外汇、指数、IPO 合成）— 这些数据并未被 CoinGecko / CMC / Coinglass 聚合。
为任何具备 MCP 能力的 AI 代理提供一个命名、结构化的接口，用于资金、流动性、仓位、流动、基差和 RWA 数据 — 由 [Usenami](https://usenami.io) 的实时 API 支持。可与 [`@usenami/signer-mcp`](https://github.com/namixai/signer-mcp) 结合使用，实现无私钥执行。
## 工具列表
| 工具 | 功能 | 费用 |
|------|--------------|------|
| `funding_screener` | 当前跨场馆资金利率（预览） | **免费** |
| `funding_arb` | 排名靠前的跨交易所资金套利候选 | 约 $0.003 |
| `funding_signal` | **决策就绪** 的资金套利信号：净费用 + 保本 + 深度大小的最大名义价值 + 流动性标志 | 约 $0.025 |
| `funding_spread` | 每种交易对的资金在各场馆的 spread | 约 $0.001 |
| `funding_history` | 历史资金利率（回测） | 约 $0.005 |
| `orderbook_slippage` | 多场馆执行成本 / 滑点 | 约 $0.005 |
| `open_interest` | 某个场馆中交易对的当前持仓量 | 约 $0.001 |
| `oi_delta` | 在一个时间窗口内的持仓量变化 | 约 $0.003 |
| `volume_24h` | 某个场馆中交易对的 24 小时永续合约交易量 | 约 $0.001 |
| `volume_anomalies` | 跨场馆的异常交易量激增 | 约 $0.003 |
| `oracle_families` | oracle 家族 / 基差风险映射 | 约 $0.001 |
| `rwa_coverage` | **HIP-3 RWA** 覆盖范围（股票 / 金属 / 石油） | 约 $0.001 |
付费工具通过 [x402 协议](https://x402.org) 在 Base 上使用 USDC 结算。设置 `X402_PRIVATE_KEY` （一个持有 USDC 的 Base 钱包），付费工具将自动支付并返回数据；如果未设置，它们将返回 x402 支付要求，以便任何支持 x402 的客户端可以支付并重试。`funding_screener` 免费且不需要钱包。
> 注意：`funding_arb` 是一个简单的扫描（不考虑费用、延迟和执行时机）— 应将其视为候选列表，而不是交易建议。
## 安装
```jsonc
{
"mcpServers": {
"usenami-funding": {
"command": "npx",
"args": ["-y", "@usenami/funding-mcp"]
}
}
}
```
可选环境变量：`USENAMI_API_BASE` （默认为 `https://api.usenami.io`）；`X402_PRIVATE_KEY` （持有 USDC 的 Base 钱包 `0x…` — 启用内置自动支付功能，用于付费工具）。
## 支持
遇到问题或需要我们尚未涵盖的数据？ **报告问题 / 请求数据：** [support@usenami.io](mailto:support@usenami.io) · 商业合作： [business@usenami.io](mailto:business@usenami.io) · Telegram: [@USnami](https://t.me/USnami).
## 本地开发
```bash
npm install
npm run build
npm start
```
MIT · [usenami.io](https://usenami.io)
