Coinlib API v1 BETA
Introduzione
Los comentarios sobre la API son bienvenidos en
info+api@coinlib.io. Aunque se trata de una BETA, creemos que será muy estable. Además, las solicitudes y respuestas no cambiarán, al menos no mucho.
Licenza
Puoi utilizzare la nostra API con una licenza Creative Commons Attribution-NonCommercial 3.0 Unported (CC BY-NC 3.0). Assicurati di
accreditarci un link se utilizzi la nostra API sul tuo sito web o sulla tua app.
Limiti di autenticazione e frequenza
Necesita una clave API para todas las llamadas API. Obtén el tuyo en tu
pagina del profilo (necesitas tener una cuenta e iniciar sesión para acceder a esta página).
Tutti gli endpoint API sono in
https://coinlib.io/api/v1 . Utilizzare
GET per accedere all'API.
Frequenza limite l'API per endpoint e per ora. Tutte le risposte includono
remaining le richieste che è possibile eseguire fino all'inizio dell'ora successiva.
- 120 richieste/ora per
/global
- 60 richieste/ora per
/coinlist
- 180 richieste/ora per
/coin
È sempre necessario emettere una richiesta alla volta, se si tenta di eseguire richieste parallele verrà restituito un 429. Infine non utilizzare più chiavi API.
Risposte
Le risposte sono in
JSON . I numeri interi (numero di monete, rango, timestamp) vengono restituiti come numeri interi. I numeri decimali vengono restituiti come stringhe,
. utilizzando un come separatore decimale e con fino a 10 cifre di precisione.
Esempio di errore:
{
"error": "Unknown pref symbol.",
"remaining": 53
}
Gli endpoint
Statistiche di mercato globali
Endpoint:
/global
Parametri richiesti:
key: API key
Parametri opzionali:
pref: simbolo da utilizzare per i prezzi e altri valori di mercato. Il valore predefinito è USD.
Esempio:
https://coinlib.io/api/v1/global?key=XXX&pref=EUR
Risultato:
{
"coins": 4329,
"markets": 13648,
"total_market_cap": "207058335320.66",
"total_volume_24h": "10413469137.11",
"last_updated_timestamp": 1528975469,
"remaining": 540
}
Lista monete
Endpoint:
/coinlist
Parametri richiesti:
key: Chiave API
Parametri opzionali:
pref: simbolo da utilizzare per i prezzi e altri valori di mercato. Il valore predefinito è USD.
page: numero intero, a partire da 1. Per ora restituiamo 100 risultati per pagina, ma questo potrebbe cambiare senza preavviso.
order:
- Per rango (dal primo all'ultimo) utilizzare
rank_asc
- Per il rango (dall'ultimo al primo) utilizzare
rank_desc
- Per il volume 24h (da basso ad alto)
volume_asc
- Per il volume 24h (da alto a basso)
volume_desc
- Per il prezzo (da basso ad alto) uso
price_asc
- Per il prezzo (da alto a basso) uso
price_desc
- Per la data indicata (da recente a precedente)
date_inserted_asc
- Per la data indicata (da meno recente a recente)
date_inserted_desc
Esempio:
https://coinlib.io/api/v1/coinlist?key=XXX&pref=BTC&page=1&order=volume_desc
Risultato:
{
"coins": [
{
"symbol": "ETH",
"show_symbol": "ETH",
"name": "Ethereum",
"rank": 2,
"price": "0.078420138035523",
"market_cap": "7847729.8474137",
"volume_24h": "260650.1638446",
"delta_24h": "5.91"
},
{...},
{...},
],
"last_updated_timestamp": 1565321123,
"remaining": 84
}
Informazioni sulla moneta
Endpoint:
/coin
Parametri richiesti:
key: Chiave API
symbol: simbolo di moneta singola o un elenco di simboli separati da virgole
Parametri opzionali:
pref: simbolo da utilizzare per i prezzi e altri valori di mercato. Il valore predefinito è USD.
Esempio:
https://coinlib.io/api/v1/coin?key=XXX&pref=EUR&symbol=BTC
Risultato:
{
"symbol": "BTC",
"show_symbol": "BTC",
"name": "Bitcoin",
"rank": 1,
"price": "5524.7112165586",
"market_cap": "94433817003.39",
"total_volume_24h": "6378793658.5432",
"low_24h": "5324.2665427149",
"high_24h": "5561.0068476948",
"delta_1h": "0.81",
"delta_24h": "0.68",
"delta_7d": "-15.26",
"delta_30d": "-25.26",
"markets": [
{
"symbol": "EUR",
"volume_24h": "123707000",
"price": "5524.7112165586",
"exchanges": [
{
"name": "Kraken",
"volume_24h": "50623900",
"price": "5520"
},
{
"name": "Bitfinex",
"volume_24h": "19314700",
"price": "5512.6"
},
{...}
]
},
{...},
{...}
],
"last_updated_timestamp": 1528987416,
"remaining": 1133
}
Note:
symbol: Sempre unico.
show_symbol: Il simbolo che la moneta sta usando. Alcune monete usano lo stesso simbolo di altre monete.
total_volume_24h: Il volume totale per tutti i mercati che questa moneta partecipa
pref valuta.
markets: Mostramos los 3 mejores pares de la moneda seleccionada. Si se negocia su moneda
pref, siempre se incluye primero.
exchanges: I primi 3 scambi per volume per la coppia.
Avanzate:
È possibile ottenere informazioni per un massimo di 10 monete con una singola chiamata. Ogni moneta viene conteggiata rispetto alla tua quota. Dare un elenco separato da virgole di simboli ad esempio:
https://coinlib.io/api/v1/coin?key=XXX&pref=EUR&symbol=BTC,ETH,XMR
Risultato in questo caso si presenta come:
{
"coins": [
{},
{},
...
],
"remaining": 534
}