Coinlib API v1 BETA

Introducción

Los comentarios sobre la API son bienvenidos en [email protected]. Aunque se trata de una BETA, creemos que será muy estable. Además, las solicitudes y respuestas no cambiarán, al menos no mucho.

Licencia

Puede utilizar nuestra API bajo una licencia Creative Commons Attribution-NonCommercial 3.0 Unported (CC BY-NC 3.0). Por favor, asegúrese de acreditarnos con un enlace si utiliza nuestra API en su sitio web o aplicación.

Límites de autenticación y tarifa

Necesita una clave API para todas las llamadas API. Obtén el tuyo en tu página de perfil (necesitas tener una cuenta e iniciar sesión para acceder a esta página).

Todos los puntos finales de la API están bajo https://coinlib.io/api/v1 . Utilice GET para acceder a la API.

Calificamos la API por punto de conexión y por hora. Todas las respuestas incluyen las remaining solicitudes que puede realizar hasta el comienzo de la siguiente hora.

Siempre debe emitir una solicitud a la vez, si intenta realizar solicitudes paralelas se devolverá un 429. Por último, no utilice varias claves de API.

Respuestas

Las respuestas están en JSON . Los números enteros (número de monedas, rango, marcas de tiempo) se devuelven como enteros. Los números decimales se devuelven como cadenas, utilizando . a como punto decimal y teniendo hasta 10 dígitos de precisión.

Ejemplo de error: 
        {
            "error": "Unknown pref symbol.",
            "remaining": 53
        }

Variables


Estadísticas del mercado global

Criterio de valoración:
/global

Params requeridos:
key: API key

Params opcionales:
pref: símbolo para utilizar para los precios y otros valores de mercado. El valor predeterminado es USD.

Ejemplo:
https://coinlib.io/api/v1/global?key=XXX&pref=EUR

Resultado: 
        {
            "coins": 4329,
            "markets": 13648,
            "total_market_cap": "207058335320.66",
            "total_volume_24h": "10413469137.11",
            "last_updated_timestamp": 1528975469,
            "remaining": 540
        }

Lista de monedas

Criterio de valoración:
/coinlist

Params requeridos:
key: Clave API

Params opcionales:
pref: símbolo para utilizar para los precios y otros valores de mercado. El valor predeterminado es USD.
page: entero, a partir de 1. Por ahora, devolvemos 100 resultados por página, pero esto puede cambiar sin previo aviso.
order: Ejemplo:
https://coinlib.io/api/v1/coinlist?key=XXX&pref=BTC&page=1&order=volume_desc

Resultado: 
        {
            "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
        }

Información de la moneda

Criterio de valoración:
/coin

Params requeridos:
key: Clave API
symbol: símbolo de una sola moneda o una lista separada por comas de símbolos

Params opcionales:
pref: símbolo para utilizar para los precios y otros valores de mercado. El valor predeterminado es USD.

Ejemplo:
https://coinlib.io/api/v1/coin?key=XXX&pref=EUR&symbol=BTC

Resultado: 
        {
            "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
        }
Notas:
symbol: Siempre único.
show_symbol: El símbolo que está usando la moneda. Algunas monedas utilizan el mismo símbolo que otras monedas.
total_volume_24h: El volumen total para todos los mercados que esta moneda participa convertido en su pref moneda.
markets: Mostramos los 3 mejores pares de la moneda seleccionada. Si se negocia su moneda pref, siempre se incluye primero.
exchanges: Los 3 mejores intercambios por volumen para el par.

Avanzado:
Puede obtener información para un máximo de 10 monedas con una sola llamada. Cada moneda se cuenta en su cuota. Dar una lista separada por comas de símbolos, es decir:
https://coinlib.io/api/v1/coin?key=XXX&pref=EUR&symbol=BTC,ETH,XMR
El resultado en este caso se parece a: 
        {
            "coins": [
                {},
                {},
                ...
            ],
            "remaining": 534
        }