# CoinMarketCap

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/coinmarketcap` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/coinmarketcap |

## Description

Harness real-time cryptocurrency data from CoinMarketCap with Piloterr API. Enhance market analysis and trading strategies.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/coinmarketcap' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "data": [
    {
      "id": 1,
      "name": "Bitcoin",
      "slug": "bitcoin",
      "tags": [
        "mineable"
      ],
      "quote": {
        "USD": {
          "price": 43000.123,
          "market_cap": 814078239761,
          "volume_24h": 25034970987,
          "last_updated": "2023-10-01T00:00:00.000Z",
          "percent_change_1h": 0.35,
          "percent_change_7d": -0.72,
          "percent_change_24h": -2.13
        }
      },
      "symbol": "BTC",
      "cmc_rank": 1,
      "platform": null,
      "date_added": "2013-04-28T00:00:00.000Z",
      "max_supply": 21000000,
      "last_updated": "2023-10-01T00:00:00.000Z",
      "total_supply": 18934787,
      "num_market_pairs": 8778,
      "circulating_supply": 18934787
    },
    {
      "id": 1027,
      "name": "Ethereum",
      "slug": "ethereum",
      "tags": [
        "mineable"
      ],
      "quote": {
        "USD": {
          "price": 3000.659,
          "market_cap": 354970134556,
          "volume_24h": 18758879489,
          "last_updated": "2023-10-01T00:00:00.000Z",
          "percent_change_1h": 0.53,
          "percent_change_7d": -1.34,
          "percent_change_24h": -3.45
        }
      },
      "symbol": "ETH",
      "cmc_rank": 2,
      "platform": null,
      "date_added": "2015-08-07T00:00:00.000Z",
      "max_supply": null,
      "last_updated": "2023-10-01T00:00:00.000Z",
      "total_supply": 118323503.374,
      "num_market_pairs": 5742,
      "circulating_supply": 118323503.374
    }
  ],
  "status": {
    "notice": null,
    "elapsed": 10,
    "timestamp": "2023-10-01T00:00:00.000Z",
    "error_code": 0,
    "credit_count": 1,
    "error_message": null
  }
}
```

## Documentation

## Overview
Harness real-time cryptocurrency data from CoinMarketCap with Piloterr API. Enhance market analysis and trading strategies.

## Quickstart
```
GET https://api.piloterr.com/v2/coinmarketcap?query=example
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search query or target identifier |

## Main use cases
- Integrate CoinMarketCap data into enrichment, analytics, and monitoring pipelines
- Automate large-scale extraction from Coinmarketcap without maintaining scrapers
- Power internal dashboards and workflow automations with live Coinmarketcap data