Cap. Marché:

Documentation API publique CoinMarketCap

Version 2


Récapitulatif des points de terminaison

Points de terminaison d'API publique

Listings

  • Endpoint: /listings/
  • Méthode: GET
  • Description: Ce point de terminaison affiche tous les listings de cryptomonnaie actifs en un seul appel. Utilisez le champ « id » sur le point de terminaison Ticker pour demander plus d'informations à propos d'une cryptomonnaie spécifique.
  • Exemple: https://api.coinmarketcap.com/v2/listings/
  • Exemple de Réponse:
    {
        "data": [
            {
                "id": 1, 
                "name": "Bitcoin", 
                "symbol": "BTC", 
                "website_slug": "bitcoin"
            }, 
            {
                "id": 2, 
                "name": "Litecoin", 
                "symbol": "LTC", 
                "website_slug": "litecoin"
            }, 
            ...
        },
        "metadata": {
            "timestamp": 1525137187, 
            "num_cryptocurrencies": 1602, 
            "error": null
        }
    ]                               

Ticker

  • Endpoint: /ticker/
  • Méthode: GET
  • Description: Ce point de terminaison affiche les données du ticker de cryptomonnaie par ordre de rang. Le nombre maximum de résultats par appel est de 100. La pagination est possible en utilisant les paramètres start et limit.
  • Paramètre facultatif:
    • (int) start - renvoie les résultats à partir du nombre spécifié (la valeur par défaut est de 1)
    • (int) limit - renvoie un maximum de [limit] résultats (la valeur par défaut est 100; la max est 100)
    • (string) sort - renvoie les résultats triés par [sort] . Les valeurs possibles sont id, rank, volume_24h, et percent_change_24h (la valeur par défaut est rank).
      Remarque : il est fortement recommandé d'utiliser id pour trier si la pagination par les résultats disponibles depuis id est la seule option de tri garanti d'être retourné en ordre cohérent.
    • (string) structure - spécifie la structure pour le champ principal de données. Les valeurs possibles sont dictionary et array (la valeur par défaut est dictionary).
    • (string) convert - renvoie les infos de tarification concernant une autre devise.
      Les valeurs de devises fiat valides sont : « AUD », « BRL », « CAD », « CHF », « CLP », « CNY », « CZK », « DKK », « EUR », « GBP », « HKD », « HUF », « IDR », « ILS », « INR », « JPY », « KRW », « MXN », « MYR », « NOK », « NZD », « PHP », « PKR », « PLN », « RUB », « SEK », « SGD », « THB », « TRY », « TWD », « ZAR »
      Les valeurs de cryptomonnaies valides sont : « BTC », « ETH », « XRP », « LTC », and « BCH »
  • Exemple: https://api.coinmarketcap.com/v2/ticker/
  • Exemple: https://api.coinmarketcap.com/v2/ticker/?limit=10
  • Exemple: https://api.coinmarketcap.com/v2/ticker/?limit=10&sort=id
  • Exemple: https://api.coinmarketcap.com/v2/ticker/?start=101&limit=10
  • Exemple: https://api.coinmarketcap.com/v2/ticker/?start=101&limit=10&sort=id
  • Exemple: https://api.coinmarketcap.com/v2/ticker/?start=101&limit=10&sort=id&structure=array
  • Exemple: https://api.coinmarketcap.com/v2/ticker/?convert=EUR&limit=10
  • Exemple: https://api.coinmarketcap.com/v2/ticker/?convert=BTC&limit=10
  • Exemple de Réponse:
    {
        "data": {
            "1": {
                "id": 1, 
                "name": "Bitcoin", 
                "symbol": "BTC", 
                "website_slug": "bitcoin", 
                "rank": 1, 
                "circulating_supply": 17008162.0, 
                "total_supply": 17008162.0, 
                "max_supply": 21000000.0, 
                "quotes": {
                    "USD": {
                        "price": 9024.09, 
                        "volume_24h": 8765400000.0, 
                        "market_cap": 153483184623.0, 
                        "percent_change_1h": -2.31, 
                        "percent_change_24h": -4.18, 
                        "percent_change_7d": -0.47
                    }
                }, 
                "last_updated": 1525137271
            }, 
            "1027": {
                "id": 1027, 
                "name": "Ethereum", 
                "symbol": "ETH", 
                "website_slug": "ethereum", 
                "rank": 2, 
                "circulating_supply": 99151888.0, 
                "total_supply": 99151888.0, 
                "max_supply": null, 
                "quotes": {
                    "USD": {
                        "price": 642.399, 
                        "volume_24h": 2871290000.0, 
                        "market_cap": 63695073558.0, 
                        "percent_change_1h": -3.75, 
                        "percent_change_24h": -7.01, 
                        "percent_change_7d": -2.32
                    }
                }, 
                "last_updated": 1525137260
            } 
            ...
        },
        "metadata": {
            "timestamp": 1525137187, 
            "num_cryptocurrencies": 1602, 
            "error": null
        }
    ]                               

Ticker (Devise Spécifique)

  • Endpoint: /ticker/{id}/
  • Méthode: GET
  • Description: Ce point de terminaison affiche les données du ticker pour une cryptomonnaie spécifique. Utilisez le champ « id » de point de terminaison Listings dans l'URL.
  • Paramètre facultatif:
    • (string) structure - spécifie la structure pour le champ principal de données. Les valeurs possibles sont dictionary et array (la valeur par défaut est dictionary).
    • (string) convert - renvoie les infos de tarification concernant une autre devise.
      Les valeurs de devises fiat valides sont : « AUD », « BRL », « CAD », « CHF », « CLP », « CNY », « CZK », « DKK », « EUR », « GBP », « HKD », « HUF », « IDR », « ILS », « INR », « JPY », « KRW », « MXN », « MYR », « NOK », « NZD », « PHP », « PKR », « PLN », « RUB », « SEK », « SGD », « THB », « TRY », « TWD », « ZAR »
      Les valeurs de cryptomonnaies valides sont : « BTC », « ETH », « XRP », « LTC », and « BCH »
  • Exemple: https://api.coinmarketcap.com/v2/ticker/1/
  • Exemple: https://api.coinmarketcap.com/v2/ticker/1/?structure=array
  • Exemple: https://api.coinmarketcap.com/v2/ticker/1/?convert=EUR
  • Exemple: https://api.coinmarketcap.com/v2/ticker/1/?convert=BCH
  • Exemple de Réponse:
    {
        "data": {
            "id": 1, 
            "name": "Bitcoin", 
            "symbol": "BTC", 
            "website_slug": "bitcoin", 
            "rank": 1, 
            "circulating_supply": 17008162.0, 
            "total_supply": 17008162.0, 
            "max_supply": 21000000.0, 
            "quotes": {
                "USD": {
                    "price": 9024.09, 
                    "volume_24h": 8765400000.0, 
                    "market_cap": 153483184623.0, 
                    "percent_change_1h": -2.31, 
                    "percent_change_24h": -4.18, 
                    "percent_change_7d": -0.47
                }
            }, 
            "last_updated": 1525137271
        },
        "metadata": {
            "timestamp": 1525237332, 
            "error": null
        }
    }               
  • Exemple de Réponse d’Erreur:
    {
        "data": null, 
        "metadata": {
            "timestamp": 1525137187, 
            "error": "id not found"
        }
    }

Données Générales

  • Endpoint: /global/
  • Méthode: GET
  • Description: Ce point de terminaison affiche les données globales trouvées en haut de coinmarketcap.com.
  • Paramètre facultatif:
    • (string) convert - renvoie les infos de tarification concernant une autre devise.
      Les valeurs de devises fiat valides sont : « AUD », « BRL », « CAD », « CHF », « CLP », « CNY », « CZK », « DKK », « EUR », « GBP », « HKD », « HUF », « IDR », « ILS », « INR », « JPY », « KRW », « MXN », « MYR », « NOK », « NZD », « PHP », « PKR », « PLN », « RUB », « SEK », « SGD », « THB », « TRY », « TWD », « ZAR »
      Les valeurs de cryptomonnaies valides sont : « BTC », « ETH », « XRP », « LTC », and « BCH »
  • Exemple: https://api.coinmarketcap.com/v2/global/
  • Exemple: https://api.coinmarketcap.com/v2/global/?convert=EUR
  • Exemple: https://api.coinmarketcap.com/v2/global/?convert=BTC
  • Exemple de Réponse:
    {
        "data": {
            "active_cryptocurrencies": 1594, 
            "active_markets": 10526, 
            "bitcoin_percentage_of_market_cap": 37.65, 
            "quotes": {
                "USD": {
                    "total_market_cap": 407690157494.0, 
                    "total_volume_24h": 30969801118.0
                }
            }, 
            "last_updated": 1525137271
        },
        "metadata": {
            "timestamp": 1525237332, 
            "error": null
        }
    }                       

Remarques

Divers

Limites

  • Veuillez limiter les demandes à moins de 30 par minute.
  • Endpoints Mise à jour toutes les 5 minutes.

Conditions d'utilisation

Vous recherchez la version 1 de l'API ?

  • Les documents sont ici.

Documentation Dernière Mise à Jour

  • 20 mai 2018