API DOCS

MarsEdge

返回 Account 返回首页

鉴权方式

VIP Pro 用户在 Account 页面生成 API Key 后，用 header 带上即可。

X-API-Key: pk_live_xxx

也支持：Authorization: Bearer pk_live_xxx

接口

当前自动化最常用的是下面这 3 个。

GET /api/keys/verify
验证 API Key 是否有效，返回 userId / plan / maskedKey / lastUsedAt。
GET /api/probboard/latest
获取当前概率板数据。guest/user 轮询用它，VIP 自动化也可以直接用它。
GET /api/probboard/stream
VIP Pro 实时 SSE 推送接口。适合高频自动化或网页实时面板。

请求参数说明

目前这几个核心接口基本不靠 query 参数，主要靠 header 鉴权。

GET /api/keys/verify
无 query 参数。把 API Key 放进 header 即可。
GET /api/probboard/latest
当前无 query 参数，直接返回整块概率板。单币筛选建议在客户端做，或后续再扩展 symbol 参数。
GET /api/probboard/stream
当前无 query 参数，建立 SSE 长连接后直接持续推送整块概率板。

curl 示例

curl -H "X-API-Key: pk_live_xxx" \
  https://marsedge.vip/api/keys/verify
curl -H "X-API-Key: pk_live_xxx" \
  https://marsedge.vip/api/probboard/latest
curl -N -H "X-API-Key: pk_live_xxx" \
  https://marsedge.vip/api/probboard/stream

Node.js 示例

const res = await fetch('https://marsedge.vip/api/probboard/latest', {
  headers: {
    'X-API-Key': 'pk_live_xxx'
  }
});
const data = await res.json();
console.log(data.plan, data.refreshMs, data.items);

Python 示例

import requests

headers = {
    'X-API-Key': 'pk_live_xxx'
}

res = requests.get('https://marsedge.vip/api/probboard/latest', headers=headers, timeout=10)
res.raise_for_status()
data = res.json()

print(data['plan'], data['refreshMs'])
for item in data['items']:
    if item['symbol'] == 'BTC':
        print('BTC up:', item['p_up_pct'], 'down:', item['p_down_pct'])

SSE 消费示例

import requests
import sseclient

headers = {
    'X-API-Key': 'pk_live_xxx',
    'Accept': 'text/event-stream'
}

resp = requests.get('https://marsedge.vip/api/probboard/stream', headers=headers, stream=True, timeout=30)
resp.raise_for_status()
client = sseclient.SSEClient(resp)

for event in client.events():
    if event.event == 'board':
        print(event.data)

Python SSE 示例依赖：pip install requests sseclient-py

返回字段

{
  "ok": true,
  "plan": "vip_pro",
  "refreshMs": 500,
  "updatedAt": "2026-04-27 14:00:00.000",
  "items": [
    {
      "symbol": "BTC",
      "p_up_pct": 74.8,
      "p_down_pct": 25.2,
      "up_bid": 0.71,
      "up_ask": 0.73,
      "down_bid": 0.27,
      "down_ask": 0.29,
      "rem_secs": 118
    }
  ]
}