> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Coin Historical Chart Data by ID

> Price, market cap and volume history for one coin over a trailing window of days.

Historical series for one coin over a trailing window set by `days`, returned as three parallel arrays: `prices`, `market_caps` and `total_volumes`. Each entry is a two-element pair of timestamp and value, and the timestamp is in milliseconds. Granularity follows `days` automatically, or force it with `interval` (`daily` or `hourly`). Use it to chart a trend ending now. For an explicit start and end use [`get_coingecko_coins_id_market_chart_range`](/docs/api-reference/coingecko/get_coingecko-coins-id-market-chart-range); for candlesticks use [`get_coingecko_coins_id_ohlc`](/docs/api-reference/coingecko/get_coingecko-coins-id-ohlc); for one specific past day use [`get_coingecko_coins_id_history`](/docs/api-reference/coingecko/get_coingecko-coins-id-history).

<Note>
  **First time?** Point any MCP client at `https://mcp.aisa.one/mcp` — Claude
  Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client
  opens a browser, you click Allow once, and there is no key to paste. The
  commands per client, and what each call costs, are on
  [aisa.one/mcp](https://aisa.one/mcp#connect).
</Note>

[Set this endpoint up in your agent →](https://aisa.one/mcp?from=/api-reference/coingecko/get_coingecko-coins-id-market-chart)


## OpenAPI

````yaml openapi/coingecko.json GET /apis/v1/coingecko/coins/{id}/market_chart
openapi: 3.1.0
info:
  description: ''
  title: CoinGecko
  version: '1'
  x-aisa-capabilities:
    idempotency: Idempotency-Key
    max_price: X-AISA-Max-Price-USD
    quote:
      header: X-AISA-Cost-Mode
      value: quote
  x-aisa-configured-paths:
    - /apis/v1/coingecko/api/{id}/volume_chart
    - /apis/v1/coingecko/coins/categories
    - /apis/v1/coingecko/coins/categories/list
    - /apis/v1/coingecko/coins/list
    - /apis/v1/coingecko/coins/markets
    - /apis/v1/coingecko/coins/{id}
    - /apis/v1/coingecko/coins/{id}/contract/{contract_address}
    - /apis/v1/coingecko/coins/{id}/contract/{contract_address}/market_chart
    - >-
      /apis/v1/coingecko/coins/{id}/contract/{contract_address}/market_chart/range
    - /apis/v1/coingecko/coins/{id}/history
    - /apis/v1/coingecko/coins/{id}/market_chart
    - /apis/v1/coingecko/coins/{id}/market_chart/range
    - /apis/v1/coingecko/coins/{id}/ohlc
    - /apis/v1/coingecko/coins/{id}/tickers
    - /apis/v1/coingecko/exchanges
    - /apis/v1/coingecko/exchanges/list
    - /apis/v1/coingecko/exchanges/{id}
    - /apis/v1/coingecko/exchanges/{id}/tickers
    - /apis/v1/coingecko/ping
    - /apis/v1/coingecko/search/trending
    - /apis/v1/coingecko/simple/price
    - /apis/v1/coingecko/simple/supported_vs_currencies
    - /apis/v1/coingecko/simple/token_price/{id}
  x-aisa-document:
    facts_hash: 8ef69318521af6ec48c85ef9b2bd710c5bab2a2a0daf19e875de4239445b5074
    generator_version: '2'
    protocol_version: '1'
    schema_version: '1'
    composer_version: '13'
    response_pending: []
    document_hash: sha256:99cbf836874aa8fa8d595f21f9fdb21cc9903f77993505541aa0610dc4b3833e
  x-aisa-plans:
    builder: 1
    display_plan: payg
    payg: 1
    similarweb_payg: 1
    team: 1
    version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
  x-aisa-provider: coingecko
  x-aisa-catalogs:
    coingecko:
      title: CoinGecko
      description: ''
      x-aisa-document:
        facts_hash: 8ef69318521af6ec48c85ef9b2bd710c5bab2a2a0daf19e875de4239445b5074
        generator_version: '2'
        protocol_version: '1'
        schema_version: '1'
      x-aisa-plans:
        builder: 1
        display_plan: payg
        payg: 1
        similarweb_payg: 1
        team: 1
        version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
      x-aisa-capabilities:
        idempotency: Idempotency-Key
        max_price: X-AISA-Max-Price-USD
        quote:
          header: X-AISA-Cost-Mode
          value: quote
servers:
  - url: https://api.aisa.one
security:
  - bearerAuth: []
paths:
  /apis/v1/coingecko/coins/{id}/market_chart:
    get:
      tags:
        - default
      summary: Coin Historical Chart Data by ID
      description: >-
        This endpoint allows you to **get the historical chart data of a coin
        including time in UNIX, price, market cap and 24hr volume based on
        particular coin ID**
      operationId: get_coingecko_coins_id_market_chart
      parameters:
        - name: id
          in: path
          required: true
          description: |-
            Coin ID. 
            *refers to [`/coins/list`](/reference/coins-list).
          schema:
            type: string
            default: bitcoin
        - name: days
          in: query
          required: true
          description: |-
            Data up to number of days ago. 
            You may use any integer or `max` for number of days.
          schema:
            type: string
            default: '1'
        - name: interval
          in: query
          required: false
          description: Data interval, leave empty for auto granularity.
          schema:
            type: string
            enum:
              - 1m
              - 5m
              - hourly
              - daily
        - name: precision
          in: query
          required: false
          description: Decimal place for currency price value.
          schema:
            type: string
            enum:
              - full
              - '0'
              - '1'
              - '2'
              - '3'
              - '4'
              - '5'
              - '6'
              - '7'
              - '8'
              - '9'
              - '10'
              - '11'
              - '12'
              - '13'
              - '14'
              - '15'
              - '16'
              - '17'
              - '18'
        - name: vs_currency
          in: query
          required: true
          description: >-
            Target currency of market data. 

            *refers to
            [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies).
          schema:
            type: string
            default: usd
      responses:
        '200':
          description: Coin historical chart data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Response860C3Ae68Ea5_CoinsMarketChart'
              example:
                prices:
                  - - 1779027899041
                    - 77953.82550382407
                  - - 1779028199661
                    - 78052.87543398788
                market_caps:
                  - - 1779027899041
                    - 1560631481361.8042
                  - - 1779028199661
                    - 1562027330524.267
                total_volumes:
                  - - 1779027899041
                    - 18688431751.857048
                  - - 1779028199661
                    - 18974828816.446976
        default:
          content:
            application/json:
              schema: {}
          description: >-
            Error response; upstream passthrough responses may use provider
            formats
components:
  schemas:
    Response860C3Ae68Ea5_CoinsMarketChart:
      type: object
      required:
        - prices
        - market_caps
        - total_volumes
      properties:
        prices:
          type: array
          description: Price data points as [timestamp, price] pairs
          items:
            type: array
            items:
              type: number
        market_caps:
          type: array
          description: Market cap data points as [timestamp, market_cap] pairs
          items:
            type: array
            items:
              type: number
        total_volumes:
          type: array
          description: Total volume data points as [timestamp, volume] pairs
          items:
            type: array
            items:
              type: number
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.