Coinlib API v1 BETA

Introdução

O feedback sobre a API é bem-vindo em [email protected]. Embora este seja um BETA achamos que será muito estável. Além disso, os pedidos e respostas não mudarão, pelo menos não muito.

Licença

Você pode usar nossa API sob uma licença Creative Commons Attribution-NonCommercial 3.0 Unported (CC BY-NC 3.0). Por favor, certifique-se de nos creditar com um link se você usar nossa API em seu site ou aplicativo.

Limites de autenticação e taxa

Você precisa de uma chave de API para todas as chamadas de API. Obtenha o seu em seu página perfil (você precisa ter uma conta e estar logado para acessar esta página).

Todos os pontos finais da API estão abaixo https://coinlib.io/api/v1 . Use GET para acessar a API.

Nós classificamos limitar a API por ponto final e por hora. Todas as respostas incluem as remaining solicitações que você pode fazer até o início da próxima hora.

Você deve sempre emitir uma solicitação de cada vez, se você tentar fazer solicitações paralelas um 429 será devolvido. Finalmente não use várias teclas de API.

Respostas

As respostas estão dentro JSON . Números inteiros (número de moedas, classificação, timestamps) são devolvidos como inteiros. Os números decimais são devolvidos como cordas, usando um . ponto decimal e tendo até 10 dígitos de precisão.

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

Pontos finais


Estatísticas do mercado global

Extremidade:
/global

Params obrigatórios:
key: API key

Params opcionais:
pref: símbolo para usar por preços e outros valores de mercado. Padrão é USD.

Exemplo:
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 moedas

Extremidade:
/coinlist

Params obrigatórios:
key: Chave API

Params opcionais:
pref: símbolo para usar por preços e outros valores de mercado. Padrão é USD.
page: inteiro, a partir de 1. Por enquanto, retornamos 100 resultados por página, mas isso pode mudar sem aviso.
order: Exemplo:
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
        }
        

Informações sobre moedas

Extremidade:
/coin

Params obrigatórios:
key: Chave API
symbol: símbolo de moeda única ou uma lista separada de círgula de símbolos

Params opcionais:
pref: símbolo para usar por preços e outros valores de mercado. Padrão é USD.

Exemplo:
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: Sempre único.
show_symbol: O símbolo que a moeda está usando. Algumas moedas usam o mesmo símbolo que outras moedas.
total_volume_24h: O volume total para todos os mercados que esta moeda participa convertido em seu pref moeda.
markets: Mostramos os 3 pares principais para a moeda selecionada. Se sua moeda pref for negociada, ela será sempre incluída primeiro.
exchanges: As 3 melhores trocas em volume para o par.

Avançado:
Você pode obter informações de até 10 moedas com uma única chamada. Cada moeda é contada contra sua cota. Dê uma lista separada de círgula de símbolos ou seja:
https://coinlib.io/api/v1/coin?key=XXX&pref=EUR&symbol=BTC,ETH,XMR
O resultado neste caso parece:
        {
            "coins": [
                {},
                {},
                ...
            ],
            "remaining": 534
        }