Cap. del mercato:

Documentazione dell'API pubblica CoinMarketCap

Versione 2


Riepilogo degli endpoint

Endpoint API pubblica

Elenchi

  • Endpoint: /listings/
  • Metodo: GET
  • Descrizione: Questo endpoint visualizza tutti gli elenchi di criptovaluta attivi in un'unica richiesta. Utilizza il campo "id" sull'endpoint Ticker per richiedere ulteriori informazioni su una criptovaluta specifica.
  • Esempio: https://api.coinmarketcap.com/v2/listings/
  • Esempio di risposta:
    {
        "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/
  • Metodo: GET
  • Descrizione: Questo endpoint visualizza i dati del ticker della criptovaluta in ordine di classifica. Il numero massimo di risultati per opzione è 100. La paginazione è possibile usando i parametri start e limit.
  • Parametri facoltativi:
    • (int) start - fornisce risultati a partire dal numero specificato (l'impostazione predefinita è 1)
    • (int) limit - fornisce un massimo di [limit] risultati (l'impostazione predefinita è100; il massimo è 100)
    • (string) sort - fornisce risultati ordinati per [sort] . I valori possibili sono id, rank, volume_24h, epercent_change_24h (l'impostazione predefinita è rank).
      Nota: si consiglia vivamente di utilizzare id per ordinare se impaginare tutti i risultati disponibili poiché id è l'unica opzione di ordinamento garantita per la restituzione in un ordine coerente.
    • (string) structure - specifica la struttura per il campo principale dei dati. I valori possibili sono dictionary e array (l'impostazione predefinita è dictionary).
    • (string) convert - fornisce le informazioni sui prezzi rispetto a un'altra valuta.
      I valori della valuta fiat validi sono: "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"
      I valori di criptovaluta validi sono: "BTC", "ETH" "XRP", "LTC", and "BCH"
  • Esempio: https://api.coinmarketcap.com/v2/ticker/
  • Esempio: https://api.coinmarketcap.com/v2/ticker/?limit=10
  • Esempio: https://api.coinmarketcap.com/v2/ticker/?limit=10&sort=id
  • Esempio: https://api.coinmarketcap.com/v2/ticker/?start=101&limit=10
  • Esempio: https://api.coinmarketcap.com/v2/ticker/?start=101&limit=10&sort=id
  • Esempio: https://api.coinmarketcap.com/v2/ticker/?start=101&limit=10&sort=id&structure=array
  • Esempio: https://api.coinmarketcap.com/v2/ticker/?convert=EUR&limit=10
  • Esempio: https://api.coinmarketcap.com/v2/ticker/?convert=BTC&limit=10
  • Esempio di risposta:
    {
        "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 (valuta specifica)

  • Endpoint: /ticker/{id}/
  • Metodo: GET
  • Descrizione: Questo endpoint visualizza i dati ticker per una criptovaluta specifica. Usa il campo "id" dagli endpoint Elenchi nell'URL.
  • Parametri facoltativi:
    • (string) structure - specifica la struttura per il campo principale dei dati. I valori possibili sono dictionary e array (l'impostazione predefinita è dictionary).
    • (string) convert - fornisce le informazioni sui prezzi rispetto a un'altra valuta.
      I valori della valuta fiat validi sono: "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"
      I valori di criptovaluta validi sono: "BTC", "ETH" "XRP", "LTC", and "BCH"
  • Esempio: https://api.coinmarketcap.com/v2/ticker/1/
  • Esempio: https://api.coinmarketcap.com/v2/ticker/1/?structure=array
  • Esempio: https://api.coinmarketcap.com/v2/ticker/1/?convert=EUR
  • Esempio: https://api.coinmarketcap.com/v2/ticker/1/?convert=BCH
  • Esempio di risposta:
    {
        "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
        }
    }               
  • Esempio di risposta all'errore:
    {
        "data": null, 
        "metadata": {
            "timestamp": 1525137187, 
            "error": "id not found"
        }
    }

Dati globali

  • Endpoint: /global/
  • Metodo: GET
  • Descrizione: Questo endpoint mostra i dati globali trovati nella parte superiore di coinmarketcap.com.
  • Parametri facoltativi:
    • (string) convert - fornisce le informazioni sui prezzi rispetto a un'altra valuta.
      I valori della valuta fiat validi sono: "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"
      I valori di criptovaluta validi sono: "BTC", "ETH" "XRP", "LTC", and "BCH"
  • Esempio: https://api.coinmarketcap.com/v2/global/
  • Esempio: https://api.coinmarketcap.com/v2/global/?convert=EUR
  • Esempio: https://api.coinmarketcap.com/v2/global/?convert=BTC
  • Esempio di risposta:
    {
        "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
        }
    }                       

Appunti

Misto

Limiti

  • Si prega di limitare le richieste a non più di 30 al minuto.
  • Gli endpoint aggiorna ogni 5 minuti.

Condizioni d'uso

  • Accedendo all'API pubblica, accetti di essere vincolato dalle Condizioni d'uso.

Cerchi l'API versione 1?

  • La documentazione è qui.

Ultimo Aggiornata Documentazione

  • 20 maggio 2018