使用说明
💎 Telegram钱包P2P SDK生态系统
Telegram钱包P2P市场的终极开发人员友好型生产级工具包。
[!警告] 非官方项目:这个SDK是一个社区驱动的独立倡议。它不隶属于Telegram、Wallet或其任何子公司,也不为其背书或与之相关。此SDK严格 只读 专为市场情报和数据监控而设计。
✨ 为什么选择这个SDK?
| 特性 | 描述 |
|---|---|
| 🚀 本地性能 | 使用本机的零依赖Node.js客户端 fetch. |
| 🐍 异步优先 | 高并发Python客户端构建于 aiohttp. |
| 🔒 类型安全 | 完全支持TypeScript和Pydantic v2模型。 |
| 🧠 人工智能集成 | 内置 MCP服务器 克劳德、Cursor等。 |
| 📈 智能 | 点差、最优价格和流动性的高级分析。 |
| 💪 韧性 | 速率限制和服务器错误的自动指数回退。 |
📦 Monorepo概述
该生态系统提供了三个强大的工具,旨在无缝集成到您的工作流程中:
graph TD
A[Wallet API] --> B[Python SDK]
A --> C[Node.js SDK]
A --> D[MCP Server]
B --> E[Analytics & Bots]
C --> F[Web Apps]
D --> G[AI Assistants]
| 包装 | 语言 | 关键技术 | 最适合 |
|---|---|---|---|
| 开发包 | Python 3.9+ |
aiohttp, Pydantic |
数据科学,交易机器人。 |
| Node.js SDK | TypeScript |
fetch, Vite |
Web前端,无服务器。 |
| MCP服务器 | TypeScript |
MCP SDK, Zod |
人工智能辅助市场分析。 |
⚡ 快速开始
1.获取API密钥
- 打开 钱包 在Telegram中。
- 首选 P2P市场 → 我的资料 → API密钥.
- 创建密钥并确保其安全!
2.实施
🐍 python
pip install telegram-wallet-p2p
from telegram_wallet_p2p import WalletP2PClient, TradeSide
async with WalletP2PClient(api_key="your_key") as client:
resp = await client.get_online_items(
crypto_currency="USDT",
fiat_currency="RUB",
side=TradeSide.SELL
)
print(f"Top Price: {resp.data[0].price}")
🌐 Node.js
npm install @furkankoykiran/telegram-wallet-p2p
import { WalletP2PClient, TradeSide } from "@furkankoykiran/telegram-wallet-p2p";
const client = new WalletP2PClient({ apiKey: "your_key" });
const { data } = await client.getOnlineItems({
cryptoCurrency: "TON",
fiatCurrency: "USD",
side: TradeSide.BUY
});
console.log(`Best Buy: ${data[0].price}`);
🤖 模型上下文协议(MCP)
立即为您的AI助手提供实时市场数据。
在VS代码/游标中安装
一键在VS Code中安装Telegram钱包P2P MCP服务器:
[!注意] 安装后,更换
YOUR_API_KEY使用您的实际钱包API密钥。
在Claude桌面中安装
将此添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"telegram-wallet-p2p": {
"command": "npx",
"args": ["-y", "@furkankoykiran/telegram-wallet-p2p-mcp"],
"env": {
"WALLET_P2P_API_KEY": "your-api-key"
}
}
}
}
💡 AI提示示例
- “查找目前可用RUB购买的最便宜的USDT。”
- “给我一份当前吨/美元市场的总结,包括商家分销。”
- “列出接受银行转账的BTC/EUR前5个销售广告。”
🤝 贡献与支持
我们欢迎捐款!请查看我们的 贡献指南 了解如何开始的详细信息。
- ⭐️ 标记回购 如果你觉得它有用。
- 🐛 打开一个问题 对于bug或功能请求。
Built with ❤️ for the community by Furkan Köykıran