---
title: "Top coins by market cap"
method: GET
path: "/api/v1/coins/top"
tags: ["coins"]
---

# Top coins by market cap

`GET /api/v1/coins/top`

## Request

- Base URL: `https://api.bitcompare.net`
- URL: `https://api.bitcompare.net/api/v1/coins/top`
- Auth: one of:
  - none
  - HTTP bearer

Top N coins ordered by market capitalisation.

## Query parameters

- `limit` integer

## Response `200`

Successful response

- object
  - `coins` object[], required
    - `id` string, required: Canonical coin ID (e.g. `bitcoin`)
    - `symbol` string, required: Trading symbol (e.g. `btc`)
    - `name` string, required: Human-readable name (e.g. `Bitcoin`)
    - `marketCap` number: Market cap in USD
    - `rank` integer: Market cap rank (1 = largest)
    - `price` number: Current spot price in USD

## Other responses

- `401`: Missing or invalid API key
- `429`: Plan rate limit exceeded — see X-RateLimit-* headers and Retry-After

---

[API](https://skmtc.dev/bitcompare/apis/bitcompare-api.md) · [All operations](https://skmtc.dev/bitcompare/apis/bitcompare-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bitcompare/apis/bitcompare-api/revisions/936dfbf752d2?raw)