---
title: "Market contract prices"
method: GET
path: "/timeseries/market-contract-prices"
tags: ["Timeseries"]
---

# Market contract prices

`GET /timeseries/market-contract-prices`

## Request

- Base URL: `https://api.coinmetrics.io/v4`
- URL: `https://api.coinmetrics.io/v4/timeseries/market-contract-prices`
- Auth: API key in query parameter `api_key`
- TypeScript: <https://skmtc.dev/coinmetrics/apis/coin-metrics-api-v4/docs/timeseries/market-contract-prices/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns contract prices for specified markets. This includes index price and mark price that are used by the exchange for settlement and risk management purposes.<br/> Results are ordered by tuple `(market, time)`.<br/> To fetch the next page of results use `next_page_url` JSON response field.<br/>

## Query parameters

- `markets` string[], required
- `start_time` string
- `end_time` string
- `start_inclusive` boolean
- `end_inclusive` boolean
- `granularity` 'raw' | '1m' | '1h' | '1d'
- `timezone` string
- `page_size` integer
- `paging_from` 'start' | 'end', PagingFrom
- `limit_per_market` integer
- `pretty` boolean
- `format` 'json' | 'csv'
- `next_page_token` string

## Response `200`

Time series of market contract prices.

- MarketContractPricesResponse
  - `data` MarketContractPrices[], required
    - `market` string, required: Unique name of the market.
    - `time` string, required: The time in ISO 8601 date-time format. Always with nanoseconds precision.
    - `mark_price` string: The price representing the futures' or option's price calculated by the exchange for risk management purposes.
    - `index_price` string: The price index is an aggregate price derived from the major exchanges to be representative of the underlying asset's market consensus price.
    - `settlement_price_estimated` string: The estimated price of the underlying asset.
    - `database_time` string, required: A time when we saved the data in the database. The time is in ISO 8601 date-time format. Always with nanoseconds precision.
    - `exchange_time` string: Time corresponding to option ticker data point, according to the exchange. Can be NULL, if exchange doesn't support it.
  - `next_page_token` string: Token of the next page results for a given request.
  - `next_page_url` string: URL of the next page results for a given request.

## Other responses

- `400`: Market not found.
- `401`: Requested resource requires authorization.
- `403`: Requested resource is not available with supplied credentials.
- `414`: Provided URI is too long. It must not be greater than 10000 symbols.

---

[API](https://skmtc.dev/coinmetrics/apis/coin-metrics-api-v4.md) - [All operations](https://skmtc.dev/coinmetrics/apis/coin-metrics-api-v4/llms.txt) - [OpenAPI document](https://skmtc.dev/coinmetrics/apis/coin-metrics-api-v4/revisions/774268c0a4fe?raw)