开放 REST API · 支持 AI Agent 接入 · 半自动交易

AI Agent 接入

通过 API Key 允许 AI Agent 代表用户查询行情、生成待签名交易对象,最终由用户本人签名确认,保障资产安全。

创建 API Key

在用户中心创建密钥,设置链白名单、Token 白名单、单笔/单日限额等

调用 API

AI Agent 通过 REST API 查询行情、生成交易参数,获得待签名对象

用户签名

待签名交易推送至用户钱包,用户确认后才实际上链执行

API 端点

GET/api/v1/balance— 查询钱包余额

参数

chainstring必填bsc / sol / base / eni

addressstring必填钱包地址

curl -H "X-Api-Key: pk_xxxxx" \
  "https://your-domain.com/api/v1/balance?chain=bsc&address=0xabc..."

GET/api/v1/positions— 查询持仓代币

参数

chainstring必填链

addressstring必填钱包地址

curl -H "X-Api-Key: pk_xxxxx" \
  "https://your-domain.com/api/v1/positions?chain=bsc&address=0x..."

GET/api/v1/token/info— 查询代币信息

参数

chainstring必填链

addressstring必填代币地址

curl -H "X-Api-Key: pk_xxxxx" \
  "https://your-domain.com/api/v1/token/info?chain=bsc&address=0x..."

GET/api/v1/token/risk— 查询合约风险评估

参数

chainstring必填链

addressstring必填代币地址

curl -H "X-Api-Key: pk_xxxxx" \
  "https://your-domain.com/api/v1/token/risk?chain=bsc&address=0x..."

POST/api/v1/swap/quote— 获取兑换报价写操作

参数

chainstring必填链

from_tokenstring必填支付代币地址

to_tokenstring必填目标代币地址

amountstring必填支付数量(字符串)

slippagenumber滑点 % (默认 0.5)

curl -X POST -H "X-Api-Key: pk_xxxxx" -H "Content-Type: application/json" \
  -d '{"chain":"bsc","from_token":"0x...","to_token":"0x...","amount":"0.1","slippage":0.5}' \
  https://your-domain.com/api/v1/swap/quote

POST/api/v1/swap/prepare— 生成待签名交易对象 (半自动)需签名

参数

chainstring必填链

from_tokenstring必填支付代币

to_tokenstring必填目标代币

amountstring必填支付数量

slippagenumber滑点

walletstring必填用户钱包地址

# 返回待签名对象,需由用户钱包签名后 broadcast
curl -X POST -H "X-Api-Key: pk_xxxxx" -H "Content-Type: application/json" \
  -d '{"chain":"bsc","from_token":"...","to_token":"...","amount":"1","wallet":"0x..."}' \
  https://your-domain.com/api/v1/swap/prepare

POST/api/v1/swap/submit— 提交已签名的交易

参数

order_nostring必填预生成订单号

signed_txstring必填已签名的交易 Hex

tx_hashstring广播后的交易哈希

curl -X POST -H "X-Api-Key: pk_xxxxx" -H "Content-Type: application/json" \
  -d '{"order_no":"WD...","signed_tx":"0x...","tx_hash":"0x..."}' \
  https://your-domain.com/api/v1/swap/submit

权限控制 & 安全机制

🔒 API 密钥控制

API Key + Secret 双认证
密钥可随时吊销或重置
支持过期时间设置
IP 白名单限制(可选)

⚡ 交易限额

单笔交易 USD 上限
单日累计 USD 上限
最大滑点容忍度
交易冷却时间

🌐 白名单策略

仅允许指定链交易
Token 白名单(默认仅 Top 100)
自动阻止高风险合约(GoPlus 评分)
黑名单地址自动拦截

🚨 风控熔断

异常频次自动熔断
价格异动预警
完整审计日志
实时风控告警

统一响应格式

{
  "code": 0,           // 0=成功, 非0=错误码
  "message": "ok",
  "data": { ... },     // 业务数据
  "ts": 1745062800000  // 服务器时间戳
}

前往用户中心创建 API Key