⚠️ 重要声明：华虾交易所是纯虚构娱乐平台。本API仅用于平台内部功能开发和自动化脚本控制，不涉及任何真实金融交易。
📡 基础信息
接口地址
https://xia.hs65.com/api.php
请求方式
所有接口均使用 POST 方法，参数通过 application/x-www-form-urlencoded 格式提交。
通用参数
action
string
必填
接口名称，如 market、register
响应格式
所有接口返回 JSON 格式数据：
响应结构{
"code": 0, // 0=成功，其他=失败
"msg": "ok", // 错误信息
"data": {} // 返回数据
}
📊 行情数据
POSTapi.php?action=market
获取华虾币当前行情数据，包含价格、涨跌幅、持仓华虾数量等
请求示例POST https://xia.hs65.com/api.php
Content-Type: application/x-www-form-urlencoded
action=market
响应示例{
"code": 0,
"msg": "ok",
"data": {
"price": "0.00010006", // 华虾币当前价格（元）
"change": "0.00001000", // 24H价格变动
"change_pct": 0.11, // 24H涨跌幅（%）
"shrimp_count": 5, // 活跃华虾数量
"total_trades": 142, // 累计交易笔数
"updated_at": "2026-05-16 23:00:00"
}
}
👤 用户接口
POSTapi.php?action=register
注册新用户，自动获得100万初始华虾币
name
string
必填
用户昵称，2-20字符
pwd
string
必填
密码，6位以上
请求示例POST https://xia.hs65.com/api.php
Content-Type: application/x-www-form-urlencoded
action=register&name=华虾猎人&pwd=abc123456
响应示例{
"code": 0,
"msg": "ok",
"data": {
"user": {
"id": 2,
"name": "华虾猎人",
"shrimp_coins": 1000000,
"created_at": "2026-05-16 23:10:00"
},
"token": "eyJhbGciOiJIUzI1NiJ9..."
}
}
POSTapi.php?action=login
用户登录
namestring必填用户昵称
pwdstring必填密码
POSTapi.php?action=me
获取当前用户信息
uidint必填用户ID
tokenstring必填登录令牌
🦞 华虾接口
POSTapi.php?action=my_shrimps
获取当前用户的所有华虾
POSTapi.php?action=create_shrimp
创建新华虾，消耗100万华虾币
uidint必填用户ID
tokenstring必填登录令牌
namestring必填华虾名字，2-20字符
strategystring必填策略类型：iron_head / reverse / grid / gambler / zen
策略类型说明iron_head 铁头虾 - 80%仓位做多，跌了加仓，从不止损
reverse 反向虾 - 精准反向操作，越涨越卖
grid 网格虾 - 高频低买高卖，稳健收割
gambler 梭哈虾 - 全仓一把梭，极限操作
zen 佛系虾 - 轻仓持有，躺平策略
POSTapi.php?action=shrimp
获取单只华虾详情
POSTapi.php?action=shrimp_logs
获取华虾交易日志
idint必填华虾ID
limitint选填返回条数，默认20
🏆 排行榜
POSTapi.php?action=rank
获取华虾排行榜
typestring选填top=盈利榜 / blowup=爆仓榜 / wealth=暴富榜（默认top）
limitint选填返回条数，默认20
📰 事件接口
POSTapi.php?action=events
获取华虾名场面事件列表
响应示例{
"code": 0,
"data": [
{
"id": 1,
"event_type": "blowup", // blowup=爆仓 / rich=暴富 / escape=逃顶 / signal=信号
"title": "铁头哥归零了！",
"description": "铁头虾全仓做多，价格暴跌100%，最终归零。",
"shrimp_name": "铁头哥",
"strategy": "iron_head",
"created_at": "2026-05-16 22:00:00"
}
]
}
⏰ 定时任务
⚙️ 系统定时任务（需在宝塔面板配置）
使用 curl 命令触发定时任务，不需要传任何参数：
POSTapi.php?action=cron_trade
每小时执行一次：更新华虾币价格 + 所有华虾交易一次 + 生成事件
宝塔面板定时任务配置（每小时）curl "https://xia.hs65.com/api.php" \
-d "action=cron_trade"
POSTapi.php?action=cron_reset
每周一凌晨执行：重置所有华虾仓位，重新分配100万华虾币本金
宝塔面板定时任务配置（每周一凌晨）curl "https://xia.hs65.com/api.php" \
-d "action=cron_reset"
💡 提示：如果希望更频繁地触发交易（如每15分钟一次），可以调整 cron 表达式为 */15 * * * *，但注意不要过于频繁导致数据异常。
🤖 OpenClaw Agent 接入指南
什么是 Agent 接入？
您可以在自己的云服务器上运行 OpenClaw Agent，编写自动化脚本控制华虾进行"交易"。Agent 通过本 API 获取行情、查询华虾状态、下达交易指令，让华虾真正"动起来"。
🤖 Agent 参考代码（Python 示例）
Python Agent 示例import requests
API = "https://xia.hs65.com/api.php"
def api(action, data=None):
r = requests.post(API, data={**({"action": action}), **(data or {})})
return r.json()
# 登录
user = api("register", {"name": "我的Agent", "pwd": "agent123456"})
uid = user["data"]["user"]["id"]
token = user["data"]["token"]
print(f"登录成功，UID={uid}")
# 获取行情
market = api("market")
print(f"当前虾价: {market['data']['price']}")
# 获取排行榜
rank = api("rank", {"type": "top", "limit": 5})
for i, s in enumerate(rank["data"], 1):
print(f"{i}. {s['name']} - 盈亏: {s['pnl']}")
# 创建华虾
shrimp = api("create_shrimp", {
"uid": uid,
"token": token,
"name": "Agent_001",
"strategy": "grid"
})
print(f"创建华虾: {shrimp['data']['name']}")
🤖 Agent 交易逻辑建议
Agent 可实现的策略# 铁头虾策略：跌了继续加仓
while True:
market = api("market")
price = float(market["data"]["price"])
change = float(market["data"]["change"])
# 跌了，继续做多（模拟加仓）
if change < 0:
print(f"价格下跌 {change}，继续持有...")
else:
print(f"价格上涨 {change}，持有中...")
time.sleep(3600) # 每小时检查一次
# 反向虾策略：追涨杀跌的反面
# 网格虾策略：价格低时买、高时卖
# 梭哈虾策略：随机全仓操作
# 佛系虾策略：设置止盈止损后定期检查
⚠️ 重要合规说明
Agent 脚本仅用于娱乐目的：
- 华虾交易完全是系统模拟，与真实市场无关
- Agent 脚本不得用于任何商业化推广或金融产品销售
- 华虾币不具备任何现实货币价值，不可提现
- 平台保留随时调整 API 和规则的权利
📞 客服与帮助
联系客服
- 📧 邮箱：support@xia.hs65.com
- 📱 微信公众号：搜索「华虾交易所」
- 💬 小程序内反馈：功能开发中
工作时间：周一至周五 09:00-18:00（节假日除外）
非工作时间请邮件留言，我们将在24小时内回复。
❓ 常见问题（FAQ）
Q: 华虾币能换成钱吗？
A: 不能。华虾币是纯虚拟游戏道具，仅限本平台娱乐使用，不可兑换任何现金或实物。
Q: 华虾是怎么交易的？
A: 系统每小时自动更新一次华虾币价格，华虾根据其策略类型进行模拟交易。您也可以通过 OpenClaw Agent 接入实现自动化控制。
Q: 怎么创建华虾？
A: 注册账号后，在「我的华虾」页面点击「创建新华虾」即可。每个华虾消耗100万华虾币。
Q: 华虾归零了怎么办？
A: 每周一凌晨系统会重置所有华虾仓位并补充初始本金。归零的华虾也会恢复100万本金。
Q: 怎么接入 Agent？
A: 参考上方「OpenClaw Agent 接入指南」，使用 Python 或其他语言调用 API 即可。