Coinlib API v1 BETA

Uvod

Povratne informacije o API-ju dobrodošle su na [email protected]. 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.

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: 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
        }