用脚本交易匿名历史行情

认证

API 文档可以在未登录时访问；真实交易接口必须使用 API Key。请先登录网页账户，点击顶部 API 生成 Key。带 Key 创建的回放会绑定账户，并在结算后进入最近 10 局和排行榜。

Authorization: Bearer redge_live_your_key

速率限制

每个 API Key 在一分钟窗口内最多请求 500 次，其中创建新回放最多 2 次。公开文档、API 概览和排行榜不计入 Key 额度；创建失败不会消耗开局额度，但仍计为一次 API 请求。

超过额度返回 429 rate_limited。脚本应读取 Retry-After 等待对应秒数，避免立即循环重试；Reset 是 Unix 秒级时间戳。

30 秒快速开始

export REPLAYEDGE_API_KEY="redge_live_..."

curl -X POST http://localhost:5178/api/v1/replays \
  -H "Authorization: Bearer $REPLAYEDGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"universe":"mega","volatility":"any","trend":"any","timeOfDay":"any","totalTicks":180,"startAtOpen":false}'

保存响应中的 data.replayId。创建成功时返回最初 60 根 K 线，之后调用 advance 才会揭示新行情。

回放生命周期

• 初始资金固定为 $100,000，最大总杠杆为 2x。
• 订单提交后不会立刻成交；市价、限价和止损触发单统一按下一根 Tick 的 open 价格计算成交，市价/止损会加滑点。
• 每个回放绑定创建它的 API Key 用户，其他用户无法读取或操作。
• 回放闲置 3 小时后可能失效。完成后成绩自动进入该用户排行榜。

行情与账户字段

错误处理

{ "error": { "code": "invalid_request", "message": "quantity 必须至少为 1 股整数。" } }

完整 Python 策略骨架

示例使用 10/20 均线交叉，按 25% 可用买力下单。它仅演示 API 生命周期，不代表投资建议。

import math
import os
import requests

BASE = "http://localhost:5178/api/v1"
HEADERS = {
    "Authorization": f"Bearer {os.environ['REPLAYEDGE_API_KEY']}",
    "Content-Type": "application/json",
}

def api(method, path, **kwargs):
    response = requests.request(method, BASE + path, headers=HEADERS, timeout=30, **kwargs)
    response.raise_for_status()
    return response.json()["data"]

replay = api("POST", "/replays", json={"universe": "mega", "totalTicks": 180, "startAtOpen": False})
replay_id = replay["replayId"]
bars = replay["revealedBars"]

while replay["status"] == "active":
    closes = [bar["c"] for bar in bars]
    fast = sum(closes[-10:]) / 10
    slow = sum(closes[-20:]) / 20
    position = replay["account"]["position"]

    if fast > slow and position == 0:
        price = replay["account"]["currentPrice"]
        qty = math.floor(replay["account"]["buyingPower"] * 0.25 / price)
        if qty >= 1:
            replay = api("POST", f"/replays/{replay_id}/orders", json={
                "side": "buy", "type": "market", "quantity": qty
            })
    elif fast < slow and position > 0:
        replay = api("POST", f"/replays/{replay_id}/orders", json={
            "side": "sell", "type": "market", "quantity": position
        })

    replay = api("POST", f"/replays/{replay_id}/advance", json={"steps": 1})
    bars.extend(replay.get("revealedBars") or [])

report = replay["report"]
print(report["symbol"], report["timeRange"], report["pnl"], report["score"])