---
title: "Get total market cap history optimized for AI analysis"
method: GET
path: "/agentFriendly/total_market_cap_history"
tags: ["AgentFriendly"]
---

# Get total market cap history optimized for AI analysis

`GET /agentFriendly/total_market_cap_history`

## Request

- Base URL: `https://rest.coincap.io/v3`
- URL: `https://rest.coincap.io/v3/agentFriendly/total_market_cap_history`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `apiKey`
  - API key in header `Payment-Signature`
- TypeScript: <https://skmtc.dev/coincap/apis/coincap-api/docs/agentFriendly/total_market_cap_history/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns ~200 intelligently sampled total market cap data points with high/low tracking within the requested time range

## Query parameters

- `start` integer
- `end` integer

## Response `200`

Total market cap history with approximately 200 data points

- object

## Other responses

- `400`: Bad request - invalid parameters
- `402`: Payment Required
- `500`: Internal server error

## Changes

- **2026-09-01** `e3d3739c2c03`: 4 info
  - the endpoint scheme security `apiKey` was added to the API
  - the endpoint scheme security `x402` was added to the API
  - added the media type `application/json` for the response with the status `200`
  - added the non-success response with the status `402`
- **2026-02-25** `b2b927ca7a7c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/coincap/apis/coincap-api/changes/agentFriendly/total_market_cap_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)