Coinlib API v1 BETA

Uvod

Povratne informacije o API-ju dobrodošle su na info+api@coinlib.io. Iako je ovo BETA, mislimo da će biti vrlo stabilna. Štoviše, zahtjevi i odgovori se neće promijeniti, barem ne puno.

Licenca

Možete koristiti naš API pod licencom Creative Commons Attribution-NonCommercial 3.0 Unported (CC BY-NC 3.0). Provjerite jeste li nas kreditirali vezom ako koristite naš API na svojoj web stranici ili u aplikaciji.

Autentifikacija & granice stope

Potreban vam je API ključ za sve API pozive. Nabavite svoje u svojoj profilnu stranicu (potrebno je imati račun i biti prijavljeni da biste pristupili ovoj stranici).

Sve API krajnje točke nalaze se pod https://coinlib.io/api/v1. Koristite GET za pristup API-ju.

Ograničavamo API po krajnjoj točki i po satu. Svi odgovori uključuju preostale zahtjeve koje možete izvršiti do početka sljedećeg sata.

120 zahtjeva/sat do /global
60 zahtjeva/sat do /coinlist
180 zahtjeva/sat za /coin

Uvijek biste trebali izdavati jedan po jedan zahtjev, ako pokušate napraviti paralelne zahtjeve, bit će vraćeno 429. Konačno, nemojte koristiti više API ključeva.

Odgovori

Odgovori su u JSON. Cijeli brojevi (broj novčića, rang, vremenske oznake) vraćaju se kao cijeli brojevi. Decimalni brojevi se vraćaju kao nizovi, koristeći . kao decimalni zarez i imaju do 10 preciznih znamenki.

Primjer pogreške:

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

Krajnje točke

Statistika globalnog tržišta

Krajnja točka:
/global

Potrebni parametri:
key: API key

Neobavezni parametri:
pref: simbol koji se koristi za cijene i druge tržišne vrijednosti. Zadana vrijednost je USD.

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

Proizlaziti:

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

Popis novčića

Krajnja točka:
/coinlist

Potrebni parametri:
key: API ključ

Neobavezni parametri:
pref: simbol koji se koristi za cijene i druge tržišne vrijednosti. Zadana vrijednost je USD.
page: cijeli broj, počevši od 1. Za sada vraćamo 100 rezultata po stranici, ali to se može promijeniti bez upozorenja.
order:

Za rang (od prvog do posljednjeg) koristiti rank_asc
Za rang (od posljednjeg do prvog) korištenje rank_desc
Za glasnoću od 24 sata (od niske do visoke) koristite volume_asc
Za glasnoću 24 sata (od visoke do niske) koristite volume_desc
Za cijenu (od niske do visoke) koristiti price_asc
Za cijenu (visoku do nisku) korištenje price_desc
Za naveden datum (od nedavno do starijeg) korištenje date_inserted_asc
Za navedeni datum (od starijih do nedavnih) koristite date_inserted_desc

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

Proizlaziti:

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

Podaci o novčićima

Krajnja točka:
/coin

Potrebni parametri:
key: API ključ
symbol: simbol jednog novčića ili popis simbola odvojenih zarezima

Neobavezni parametri:
pref: simbol koji se koristi za cijene i druge tržišne vrijednosti. Zadana vrijednost je USD.

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

Proizlaziti:

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

Bilješke:
symbol: Uvijek jedinstven.
show_symbol: Simbol koji novčić koristi. Neki novčići koriste isti simbol kao i drugi novčići.
total_volume_24h: Ukupni volumen za sva tržišta na kojima ovaj novčić sudjeluje pretvoren u vaš pref valuta.
markets: Prikazujemo prva 3 para za odabrani novčić. Ako se vašom valutom pref trguje, ona je uvijek prva uključena.
exchanges: Prva 3 se razmjenjuju po volumenu za par.

Napredna:
Možete dobiti informacije za do 10 kovanica jednim pozivom. Svaki novčić se računa u vašu kvotu. Navedite popis simbola odvojenih zarezima, npr.:
https://coinlib.io/api/v1/coin?key=XXX&pref=EUR&symbol=BTC,ETH,XMR
Rezultat u ovom slučaju izgleda ovako:

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