---
title: "Get market cap history for an asset"
method: GET
path: "/assets/{slug}/marketcap-history"
tags: ["Assets"]
---

# Get market cap history for an asset

`GET /assets/{slug}/marketcap-history`

## Request

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

LEGACY — prefer /agentFriendly/asset_mcap_history/{slug}, which returns ~200 sampled points sized for model context windows. Returns historical market cap (price * supply) data for the specified asset from the 2-hour interval table

## Path parameters

- `slug` string, required

## Query parameters

- `start` integer
- `end` integer

## Response `200`

Market cap history data

- object
  - `timestamp` integer
  - `data` object[]
    - `marketCapUsd` string
    - `time` integer
    - `date` string

## Other responses

- `400`: Invalid parameters
- `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/:slug/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)