> ## Documentation Index
> Fetch the complete documentation index at: https://docs.forevex.trade/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /leaderboard

> 返回首页榜单 JSON；需要已配置的 PostgreSQL 与榜单数据。

返回首页 **榜单** JSON，供前端列表页使用。依赖已连接 **PostgreSQL** 及库内榜单相关数据（分析写缓存时会更新排行榜等，详见主仓库 README）。

## 查询参数

| 参数      | 说明                          |
| ------- | --------------------------- |
| `limit` | 返回条数，**默认 30**，范围 **1～100** |

## 示例

```bash theme={null}
curl -s "http://127.0.0.1:3000/leaderboard?limit=20" | jq .
```

若未配置数据库或尚无数据，行为以服务端实现为准（可能为空列表或错误响应）；部署前请在目标环境实测。


## OpenAPI

````yaml GET /leaderboard
openapi: 3.1.0
info:
  title: Polymarket Account Analyzer API
  description: >-
    只读 REST API：钱包分析报告（AnalyzeReport JSON）与榜单。由 `polymarket-account-analyzer
    serve` 提供。
  version: 1.0.0
servers:
  - url: http://127.0.0.1:3000
    description: 本地默认（serve --bind 127.0.0.1:3000）
security: []
paths:
  /leaderboard:
    get:
      summary: 榜单
      description: 返回首页榜单 JSON；需要已配置的 PostgreSQL 与榜单数据。
      parameters:
        - name: limit
          in: query
          description: 返回条数，默认 30，范围 1～100
          schema:
            type: integer
            default: 30
            minimum: 1
            maximum: 100
      responses:
        '200':
          description: 榜单 JSON
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true

````