# MarsEdge API 文档

基础地址：`https://marsedge.vip`

机器可读 OpenAPI：https://marsedge.vip/openapi.json

## 鉴权

使用有效的 Pro API Key，并选择以下任一 Header：

```http
X-API-Key: pk_live_xxx
```

```http
Authorization: Bearer pk_live_xxx
```

## 接口

### GET /api/health

公开的服务健康与状态接口。

### GET /api/keys/verify

需要 API Key。返回 `userId`、`plan`、`maskedKey` 与 `lastUsedAt`。

### GET /api/probboard/latest

返回完整的最新概率板。游客可以在限流规则内访问；登录或付费档位可能获得更快的刷新权益。

主要字段：

- `plan`、`refreshMs`、`updatedAt`、`servedAt`
- `dataAgeMs`、`latencyLevel`、`isStale`
- `items[].symbol`
- `items[].p_up_pct`、`items[].p_down_pct`
- `items[].up_bid`、`items[].up_ask`
- `items[].down_bid`、`items[].down_ask`
- `items[].up_token_id`、`items[].down_token_id`
- `items[].rem_secs`

### GET /api/probboard/stream

VIP Pro 实时 SSE 接口。需要 Pro 登录会话或有效的 Pro API Key，更新事件类型为 `board`。

## curl

```bash
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
```

## 使用注意

- 遵守返回的 `refreshMs` 权益与 HTTP 429 重试提示。
- 概率是模型输出，不代表结果保证。
- 不要把 API Key 暴露在公开客户端代码、日志或分享给第三方的提示中。