---
title: "Live LLM arena leaderboards with rank deltas, context length and $/M-token pricing"
method: GET
path: "/api/v1/benchmarks"
---

# Live LLM arena leaderboards with rank deltas, context length and $/M-token pricing

`GET /api/v1/benchmarks`

## Request

- Base URL: `https://heatpulse.cc`
- URL: `https://heatpulse.cc/api/v1/benchmarks`
- Auth: none declared

Six boards: text, code, agent, document, vision, search. Score is arena Elo; votes are vote counts — except the agent board (score = net-improvement %, votes = sessions; see each board's note). delta is rank movement vs the previous captured snapshot; null when no baseline exists. context/priceIn/priceOut come from the OpenRouter public catalog; null when the arena name has no catalog match.

## Query parameters

- `board` 'text' | 'code' | 'agent' | 'document' | 'vision' | 'search'
- `limit` integer

## Response `200`

Boards

- Benchmarks
  - `asOf` string: Upstream snapshot date YYYY-MM-DD
  - `boards` object[]
    - `key` string
    - `label` string
    - `note` string, nullable
    - `sourceUrl` string, nullable
    - `lastUpdated` string, nullable
    - `modelCount` integer, nullable
    - `rows` object[]
      - `rank` integer
      - `model` string
      - `vendor` string
      - `license` string
      - `score` number
      - `votes` integer, nullable
      - `delta` integer, nullable: rank movement vs previous snapshot; positive = climbed
      - `isNew` boolean
      - `context` integer, nullable
      - `priceIn` number, nullable: USD per 1M input tokens
      - `priceOut` number, nullable: USD per 1M output tokens

## Other responses

- `400`: Unknown board

---

[API](https://skmtc.dev/heatpulse/apis/heatpulse-agent-api.md) · [All operations](https://skmtc.dev/heatpulse/apis/heatpulse-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/heatpulse/apis/heatpulse-agent-api/revisions/13aa08eaae7e?raw)