# Arena API: Get leaderboard

> Gets the ranked AI models of an LMArena (Arena) leaderboard with scores, confidence intervals, votes, organizations, licenses and the date the leaderboard was last updated.

Unofficial. Not affiliated with or endorsed by Arena.

- Page: https://fous.com/methods/arena.ai/get-leaderboard
- Method: `arena.ai/get_leaderboard`, version 1
- Website: arena.ai
- Returns: last updated date; models with rank, name, organization, score, confidence interval, votes, license, leaderboard link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `category` | string | no | `"text"` | Arena to rank, for example text or webdev. Available: text, webdev, vision, text_to_image, image_edit, search, text_to_video. One of "text", "webdev", "vision", "text_to_image", "image_edit", "search", "text_to_video". Default "text". |
| `max_results` | integer | no | `25` | Maximum models to return, for example 25 (up to 200). Default 25. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "category": "text",
  "max_results": 25
}
```

Its output:

```json
{
  "models": [
    {
      "rank": 1,
      "votes": 2307,
      "license": "Proprietary",
      "model_name": "claude-opus-5.5-high",
      "arena_score": 1509,
      "organization": "Anthropic",
      "leaderboard_link": "https://arena.ai/leaderboard/text",
      "confidence_interval": "±12"
    },
    {
      "rank": 2,
      "votes": 76518,
      "license": "Proprietary",
      "model_name": "claude-opus-4-6-high",
      "arena_score": 1505,
      "organization": "Anthropic",
      "leaderboard_link": "https://arena.ai/leaderboard/text",
      "confidence_interval": "±3"
    },
    {
      "rank": 3,
      "votes": 36462,
      "license": "Proprietary",
      "model_name": "claude-fable-5-high",
      "arena_score": 1504,
      "organization": "Anthropic",
      "leaderboard_link": "https://arena.ai/leaderboard/text",
      "confidence_interval": "±4"
    }
  ],
  "last_updated": "2026-09-25"
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"arena.ai/get_leaderboard","input":{"category":"text","max_results":25}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Show me the top 10 models on the LMArena text leaderboard with their scores and vote counts
- Which AI models currently rank highest for web development? I need the top 20 with organizations and licenses
- Pull the current text-to-image model rankings, including confidence intervals and when the board was last updated
- Get the arena.ai vision leaderboard, top 50 models
- What are the best-ranked text-to-video models right now and who makes them? Just the top 5

## Input schema

```json
{
  "type": "object",
  "properties": {
    "category": {
      "enum": [
        "text",
        "webdev",
        "vision",
        "text_to_image",
        "image_edit",
        "search",
        "text_to_video"
      ],
      "type": "string",
      "default": "text",
      "description": "Arena to rank, for example text or webdev. Available: text, webdev, vision, text_to_image, image_edit, search, text_to_video."
    },
    "max_results": {
      "type": "integer",
      "default": 25,
      "maximum": 200,
      "minimum": 1,
      "description": "Maximum models to return, for example 25 (up to 200)."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "last_updated",
    "models"
  ],
  "properties": {
    "models": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "rank",
          "model_name",
          "organization",
          "arena_score",
          "confidence_interval",
          "votes",
          "license",
          "leaderboard_link"
        ],
        "properties": {
          "rank": {
            "type": "integer",
            "description": "Rank on the selected leaderboard."
          },
          "votes": {
            "type": "integer",
            "description": "Number of votes for this model."
          },
          "license": {
            "type": [
              "string",
              "null"
            ],
            "description": "Displayed model license."
          },
          "model_name": {
            "type": "string",
            "description": "Displayed model name."
          },
          "arena_score": {
            "type": "integer",
            "description": "Displayed Arena score."
          },
          "organization": {
            "type": [
              "string",
              "null"
            ],
            "description": "Organization behind the model."
          },
          "leaderboard_link": {
            "type": "string",
            "description": "Public page for this leaderboard."
          },
          "confidence_interval": {
            "type": [
              "string",
              "null"
            ],
            "description": "Confidence interval exactly as displayed, such as ±12 or +18/-18."
          }
        },
        "additionalProperties": false
      },
      "description": "Models in the order shown on the leaderboard."
    },
    "last_updated": {
      "type": "string",
      "format": "date",
      "description": "Date the selected leaderboard was last updated (YYYY-MM-DD)."
    }
  },
  "additionalProperties": false
}
```

## See more

- [Polymarket API: List trending markets](https://fous.com/methods/polymarket.com/list-trending-markets.md): Lists the open Polymarket markets with the most trading in the last 24 hours. You can pick one category or list all of them; markets outside the named categories are labeled Other.
- [Twitch API: List top categories](https://fous.com/methods/twitch.tv/list-top-categories.md): Lists Twitch games and categories ranked by current live viewers, with content tags, box art and category links.
- [CoinGecko API: List crypto categories](https://fous.com/methods/coingecko.com/list-crypto-categories.md): Lists CoinGecko crypto sectors by market cap with daily change, volume, leading coins and category pages, optionally filtered by name or link.
- [Similarweb API: List top websites](https://fous.com/methods/similarweb.com/list-top-websites.md): Lists Similarweb's most visited websites for a category and country, with rankings and engagement figures for the reported month. Anonymous view limits may restrict results, especially for country rankings.
- [Chess.com API: List top players](https://fous.com/methods/chess.com/list-top-players.md): Lists up to 50 top Chess.com players for a time control, in rank order, with ratings, game records and profile links. Puzzles rankings use puzzle scores.
- [Bilibili API: List popular videos](https://fous.com/methods/bilibili.com/list-popular-videos.md): Lists the current Bilibili ranking overall or in a selected category, in rank order. The Movies ranking does not provide uploader, likes, length or BV numbers.
- [Product Hunt API: List daily launches](https://fous.com/methods/producthunt.com/list-launches.md): Lists featured launches in Product Hunt's daily leaderboard order for a given US Pacific day, with each product's website when its public page shows one.
- [Hugging Face API: List trending models](https://fous.com/methods/huggingface.co/list-trending-models.md): Lists Hugging Face models in trending order this week, optionally filtered to one task. Downloads cover the last 30 days.