> For AI agents: the complete documentation index is available at https://docs.reelway.ai/llms.txt, the full documentation bundle is available at https://docs.reelway.ai/llms-full.txt.

# 余额与用量

账户维度的资金与身份查询。除标注公开的端点外,全部以**账户凭证**鉴权,只返回凭证所有者的数据。

## 账户身份


GEThttps://rcn.reelway.ai/v1/account/me鉴权:账户

完整资料(邮箱验证状态等)



GEThttps://rcn.reelway.ai/v2/account/me鉴权:账户

精简 {walletAddress, username, emailVerified}


## 余额


GEThttps://rcn.reelway.ai/v4/account/balance鉴权:账户

账户余额(BalanceV4 形状)


```bash
curl --fail-with-body https://rcn.reelway.ai/v4/account/balance \
  -H "api-key: $REELWAY_API_KEY"
```

作为**余额监控与快速开始的第一调用**:无副作用、廉价、可直接验证 Key 有效性。WebSocket 通道的 `authenticated` 首帧同样携带余额(`balanceVersion: 2`)。

## 流水


GEThttps://rcn.reelway.ai/v1/transactions/list?limit=<n>&offset=<n>鉴权:账户

流水分页;整页 50 条时返回 next=offset+页大小


响应 `{transactions[], next}`:`next` 存在时用其作为下一页 `offset` 继续翻页,缺失表示末页。适合对账与消费审计;按 Key 拆分的用量见控制台 Key 列表。

## 公告


GEThttps://rcn.reelway.ai/v1/announcements/active?platform=<name>鉴权:可选

有效公告,上限 50 条,pinned 优先;有凭证时排除已 dismiss



POSThttps://rcn.reelway.ai/v1/announcements/{id}/dismiss鉴权:凭证

标记公告为已读(幂等)


## 排行榜


GEThttps://rcn.reelway.ai/v1/leaderboard?type=<type>&period=<period>鉴权:可选

仅两类:consumption|spending(账本聚合)与 creations|jobs(完成项目数);period: day|lifetime


未实现类型返回 `422`(`1001`);上限 50 名,形状 `{leaderboard[{rank, artist, value}]}`。

## 控制台数据面(console)

`/console/*` 端点(`GET /console/me`、`GET /console/ledger`、`GET /console/usage`、`GET /console/subscription` 等)为**控制台后端专用**:以 service key + `X-Console-User` 断言头鉴权,供 [dashboard.reelway.ai](https://dashboard.reelway.ai) 调用,不面向第三方开发者。第三方用途请使用本页其余端点。