Coinlib API v1 BETA

Wstęp

Opinie na temat interfejsu API są mile widziane w info+api@coinlib.io. Chociaż jest to BETA uważamy, że będzie bardzo stabilny. Co więcej, prośby i odpowiedzi nie zmienią się, przynajmniej nie bardzo.

Licencja

Możesz korzystać z naszego API na licencji Creative Commons Uznanie autorstwa-Użycie niekomercyjne 3.0 Unported (CC BY-NC 3.0). Upewnij się, że zasilisz nas linkiem, jeśli korzystasz z naszego API na swojej stronie internetowej lub w aplikacji.

Limity uwierzytelniania i szybkości

Potrzebny jest klucz interfejsu API dla wszystkich wywołań interfejsu API. Pobierz swój strona profilu (musisz mieć konto i być zalogowanym, aby uzyskać dostęp do tej strony).

Wszystkie punkty końcowe interfejsu API są w obszarze https://coinlib.io/api/v1 . Służy GET do uzyskiwania dostępu do interfejsu API.

Mamy limit szybkości interfejsu API na punkt końcowy i na godzinę. Wszystkie odpowiedzi zawierają remaining żądania, które można wykonać do początku następnej godziny.

120 żądań na godzinę /global
60 żądań na godzinę /coinlist
180 żądań na godzinę /coin

Zawsze należy wydać jedno żądanie w czasie, jeśli spróbujesz zrobić równoległe żądania 429 zostaną zwrócone. Na koniec nie należy używać wielu kluczy interfejsu API.

Odpowiedzi

Odpowiedzi są w JSON . Liczby całkowite (liczba monet, ranga, znaczniki czasu) są zwracane jako liczby całkowite. Liczby dziesiętne są zwracane jako ciągi, przy użyciu . jako dziesiętnego i posiadające maksymalnie 10 cyfr precyzyjnych.

Przykład błędu:

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

Punkt końcowy

Statystyki rynku globalnego

Punktu końcowego:
/global

Wymagane params:
key: API key

Opcjonalne params:
pref: do wykorzystania w cenach i innych wartościach rynkowych. Wartość domyślna to USD.

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

Wynik:

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

Lista monet

Punktu końcowego:
/coinlist

Wymagane params:
key: Klucz API

Opcjonalne params:
pref: do wykorzystania w cenach i innych wartościach rynkowych. Wartość domyślna to USD.
page: integer, począwszy od 1. Na razie zwracamy 100 wyników na stronę, ale może się to zmienić bez ostrzeżenia.
order:

Do rangi (od pierwszej do ostatniej) użyj rank_asc
Do rangi (od ostatniego do pierwszego) użyj rank_desc
Dla objętości 24h (od niskiej do wysokiej) volume_asc
Dla objętości 24h (od wysokiej do niskiej) volume_desc
W cenie (od niskiej do wysokiej) price_asc
W cenie (od wysokiej do najniższej) price_desc
W przypadku podanych dat (od niedawna do starszych) date_inserted_asc
Data wymieniona (od ostatniego do starszego) date_inserted_desc

Przykład:
https://coinlib.io/api/v1/coinlist?key=XXX&pref=BTC&page=1&order=volume_desc

Wynik:

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

Informacje o monetach

Punktu końcowego:
/coin

Wymagane params:
key: Klucz API
symbol: symbol pojedynczej monety lub oddzielona przecinkami lista symboli

Opcjonalne params:
pref: do wykorzystania w cenach i innych wartościach rynkowych. Wartość domyślna to USD.

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

Wynik:

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

Notatki:
symbol: Zawsze wyjątkowy.
show_symbol: Symbol, z w który korzysta moneta. Niektóre monety używają tego samego symbolu co inne monety.
total_volume_24h: Łączna wielkość na wszystkich rynkach, na które ta moneta uczestniczy, jest przeliczona pref waluta.
markets: Pokazujemy 3 najlepsze pary dla wybranej monety. Jeśli twoja waluta pref jest przedmiotem obrotu, zawsze jest ona uwzględniana jako pierwsza.
exchanges: Top 3 wymienia się objętościowo dla pary.

Zaawansowane:
Możesz uzyskać informacje o maksymalnie 10 monetach za pomocą jednego połączenia. Każda moneta jest wliczona do twojego limitu. Podaj oddzieloną przecinków listę symboli tj.:
https://coinlib.io/api/v1/coin?key=XXX&pref=EUR&symbol=BTC,ETH,XMR
Wynik w tym przypadku wygląda następująco:

        {
            "coins": [
                {},
                {},
                ...
            ],
            "remaining": 534
        }