---
title: "Retrieve historical data for a specific asset"
method: GET
path: "/assets/{slug}/history"
tags: ["Assets"]
---

# Retrieve historical data for a specific asset

`GET /assets/{slug}/history`

## Request

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

Retrieve historical data for a specific asset by slug (id). 'interval' is REQUIRED (one of m1, m5, m15, m30, h1, h2, h6, h12, d1). 'start' and 'end' (UNIX ms) must be provided together — sending 'start' alone returns HTTP 400. Omit both to get the most recent window.

## Path parameters

- `slug` string, required

## Query parameters

- `interval` 'm1' | 'm5' | 'm15' | 'm30' | 'h1' | 'h2' | 'h6' | 'h12' | 'd1', required
- `start` integer
- `end` integer

## Response `200`

Historical data for the asset

- object
  - `timestamp` integer
  - `data` object[]
    - `priceUsd` string
    - `time` integer
    - `date` string, date-time

## Other responses

- `404`: Asset not found
- `500`: Internal server error

## Changes

- **2026-09-01** `e3d3739c2c03`: 1 breaking, 10 info
  - the `query` request parameter `interval` was restricted to a list of enum values
  - the endpoint scheme security `apiKey` was added to the API
  - added the new enum value `d1` to the `query` request parameter `interval`
  - added the new enum value `h1` to the `query` request parameter `interval`
  - …7 more

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