ZKE交易SDK
官方 ZKE交易所交易SDK 有AI代理支持。
此存储库为与ZKE Exchange交互提供了一个完整的开发人员工具包。
它包括:
•Python交易SDK\
•WebSocket市场数据客户端\
•CLI交易工具\
•用于AI代理的本地MCP服务器\
•OpenClaw插件集成\
•自动安装脚本
SDK使开发人员和AI代理能够与 ZKE现货和期货API安全高效。
特性
斑点
•市场数据\
•交易\
•钱包余额\
•订单管理\
•资产转移\
•提款历史
期货
•市场数据\
•职位管理\
•订单管理\
•有条件订单\
•利润调整\
•杠杆控制
高级集成
•Python应用程序\
•通过MCP的AI代理\
•OpenClaw插件工具\
•WebSocket实时市场流
快速开始
安装SDK```bash
curl -s https://raw.githubusercontent.com/ZKE-Exchange/zke-trading-sdk/main/install.sh | bash
安装OpenClaw插件```bash
bash <(curl -s "https://raw.githubusercontent.com/ZKE-Exchange/zke-trading-sdk/main/install_openclaw_plugin.sh?v=$RANDOM")
存储库结构```
zke-trading-sdk
│
├── main.py
├── mcp_server.py
├── config.example.json
├── requirements.txt
│
├── install.sh
├── install_openclaw_plugin.sh
│
├── tools
│ ├── account_service.py
│ ├── common.py
│ ├── errors.py
│ ├── field_mapper.py
│ ├── formatters.py
│ ├── futures_account_service.py
│ ├── futures_order_service.py
│ ├── futures_private.py
│ ├── futures_public.py
│ ├── futures_service.py
│ ├── margin_order_service.py
│ ├── margin_private.py
│ ├── market_service.py
│ ├── order_service.py
│ ├── spot_private.py
│ ├── spot_public.py
│ ├── symbol_utils.py
│ ├── transfer_service.py
│ ├── withdraw_service.py
│ ├── ws_client.py
│ ├── ws_parser.py
│ └── ws_service.py
│
├── openclaw-plugin
│ ├── src
│ │ ├── index.ts
│ │ ├── python.ts
│ │ └── types.ts
│ │
│ ├── skills
│ │ └── zke_trading
│ │ └── SKILL.md
│ │
│ ├── package.json
│ ├── openclaw.plugin.json
│ └── tsconfig.json
│
├── docs
│ ├── cli.md
│ ├── openclaw.md
│ └── examples
│
└── README.md
______________________________________________________________________
# 配置
创建配置文件```bash
cp config.example.json config.json
配置示例```json
{
"spot": {
"base_url": "https://openapi.zke.com",
"api_key": "YOUR_SPOT_API_KEY",
"api_secret": "YOUR_SPOT_API_SECRET",
"recv_window": 5000
},
"futures": {
"base_url": "https://futuresopenapi.zke.com",
"api_key": "YOUR_FUTURES_API_KEY",
"api_secret": "YOUR_FUTURES_API_SECRET",
"recv_window": 5000
},
"ws": {
"url": "wss://ws.zke.com/kline-api/ws"
}
}
创建API密钥
https://www.zke.com/en_US/personal/apiManagement
推荐权限
•阅读\
•贸易
除非需要,否则禁用提款权限。
______________________________________________________________________
# CLI使用情况
示例```bash
python main.py ticker BTCUSDT
python main.py depth BTCUSDT
python main.py balance
python main.py positions
输出示例```
{
"high": "68539.78",
"low": "67446.38",
"last": "67621.67"
}
______________________________________________________________________
# Python SDK示例
## 现场示例```python
from tools.spot_private import SpotPrivateApi
from tools.zke_client import ZKEClient
client = ZKEClient(
base_url="https://openapi.zke.com",
api_key="YOUR_KEY",
api_secret="YOUR_SECRET"
)
spot = SpotPrivateApi(client)
balance = spot.account()
print(balance)
期货示例```python
from tools.futures_private import FuturesPrivateApi
from tools.zke_client import ZKEClient
client = ZKEClient(
base_url="https://futuresopenapi.zke.com",
api_key="YOUR_KEY",
api_secret="YOUR_SECRET"
)
futures = FuturesPrivateApi(client)
positions = futures.account()
print(positions)
______________________________________________________________________
# WebSocket支持
模块```
tools/ws_client.py
tools/ws_parser.py
tools/ws_service.py
支持的流
•自动收报机\
•订单深度\
•贸易流\
•克莱恩
示例```python
from tools.ws_service import WSService
ws = WSService()
ws.subscribe_ticker("BTCUSDT")
ws.run()
______________________________________________________________________
# MCP服务器
运行MCP服务器```bash
python mcp_server.py
MCP工具
斑点```
zke_get_spot_ticker
zke_get_spot_depth
zke_get_spot_klines
zke_get_spot_account
zke_get_spot_nonzero_balances
zke_get_spot_balance
zke_get_spot_account_by_type
zke_get_spot_open_orders
zke_get_spot_my_trades
zke_get_spot_my_trades_v3
zke_get_spot_history_orders
zke_create_spot_order
zke_cancel_spot_order
## 资产```
zke_transfer_spot_to_futures
zke_transfer_futures_to_spot
zke_get_transfer_history
zke_create_withdraw
zke_get_withdraw_history
边距```
zke_create_margin_order
zke_get_margin_order
zke_cancel_margin_order
zke_get_margin_open_orders
zke_get_margin_my_trades
## 期货```
zke_get_futures_ticker
zke_get_futures_index
zke_get_futures_depth
zke_get_futures_klines
zke_get_futures_balance
zke_get_futures_positions
zke_get_futures_order
zke_get_futures_open_orders
zke_get_futures_my_trades
zke_get_futures_order_history
zke_get_futures_profit_history
zke_get_futures_transaction_history
zke_create_futures_order
zke_create_futures_condition_order
zke_cancel_futures_order
zke_cancel_all_futures_orders
zke_edit_futures_position_mode
zke_edit_futures_margin_mode
zke_adjust_futures_position_margin
zke_edit_futures_leverage
OpenClaw插件
安装插件```bash
curl -s https://raw.githubusercontent.com/ZKE-Exchange/zke-trading-sdk/main/install_openclaw_plugin.sh | bash
验证```bash
openclaw plugins list
预期```
ZKE Trading
Status: loaded
______________________________________________________________________
# 重要的OpenClaw设置
编辑```
~/.openclaw/openclaw.json
集```json
"tools": {
"profile": "full"
}
更新后重新启动OpenClaw。
______________________________________________________________________
# 建筑
## 主控程序```
AI Agent
│
▼
MCP Server
│
▼
Python SDK
│
├─ REST API
└─ WebSocket
开爪```
AI Agent
│
▼
OpenClaw Plugin
│
▼
Python SDK
│
├─ REST API
└─ WebSocket
```
安全通告
永远不要公开您的API密钥。
推荐权限
•阅读\
•贸易
除非必要,否则禁用提款权限。
ZKE交易所
官方网站
https://www.zke.com
API 文档
https://help.zke.com/api_en/
许可证
MIT许可证
