---
title: "Retrieve total market cap history"
method: GET
path: "/assets/totals/total-marketcap-history"
tags: ["Assets"]
---

# Retrieve total market cap history

`GET /assets/totals/total-marketcap-history`

## Request

- Base URL: `https://rest.coincap.io/v3`
- URL: `https://rest.coincap.io/v3/assets/totals/total-marketcap-history`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `apiKey`

LEGACY — prefer /agentFriendly/total_market_cap_history, which returns ~200 sampled points sized for model context windows. Retrieve the total market cap history for all assets.

## Response `200`

Successfully retrieved market cap history

## Other responses

- `404`: Market cap history not found
- `500`: Internal server error

## Changes

- **2026-09-01** `e3d3739c2c03`: 2 info
  - the endpoint scheme security `apiKey` was added to the API
  - the endpoint scheme security `bearerAuth` was added to the API
- **2026-02-25** `b2b927ca7a7c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/coincap/apis/coincap-api/changes/assets/totals/total-marketcap-history/get.md)

---

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