---
title: "Get markets by coin ID"
method: GET
path: "/coins/{coin_id}/markets"
tags: ["Coins"]
---

# Get markets by coin ID

`GET /coins/{coin_id}/markets`

## Request

- Base URL: `https://api.coinpaprika.com/v1`
- URL: `https://api.coinpaprika.com/v1/coins/{coin_id}/markets`
- Auth: none required
- TypeScript: <https://skmtc.dev/coinpaprika/apis/coinpaprika-api/docs/coins/:coin_id/markets/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns all available markets for a given coin.

On Business, Ultimate and Enterprise plans each entry also includes `circulating_supply`: the circulating supply implied by the entry, calculated as `market_cap / close` in USD (an approximation, not a recorded supply value). The field is omitted on other plans and when market cap or price is missing.

**Available on the following API plans:**
- Free
- Starter
- Pro
- Business
- Ultimate
- Enterprise

**Update interval:** Every 1 minute.

## Path parameters

- `coin_id` string, required

## Query parameters

- `quotes` string

## Response `200`

successful operation

- CoinMarket[]
  - `exchange_id` string
  - `exchange_name` string
  - `pair` string
  - `base_currency_id` string
  - `base_currency_name` string
  - `quote_currency_id` string
  - `quote_currency_name` string
  - `market_url` string
  - `category` string
  - `fee_type` string
  - `outlier` boolean
  - `adjusted_volume_24h_share` number
  - `quotes` MarketQuotes
    - `$KEY` MarketQuote
      - `price` number
      - `volume_24h` number
  - `last_updated` string

## Other responses

- `404`: not found
- `429`: too many requests

---

[API](https://skmtc.dev/coinpaprika/apis/coinpaprika-api.md) - [All operations](https://skmtc.dev/coinpaprika/apis/coinpaprika-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coinpaprika/apis/coinpaprika-api/revisions/36a2a796d93f?raw)