Coinlib API v1 BETA

Úvod

Spätná väzba na API je vítaná na info+api@coinlib.io. Hoci ide o BETA, myslíme si, že bude veľmi stabilná. Navyše požiadavky a odpovede sa nezmenia, aspoň nie veľmi.

Licencia

Naše API môžete používať pod licenciou Creative Commons Attribution-NonCommercial 3.0 Unported (CC BY-NC 3.0). Ak na svojej webovej lokalite alebo v aplikácii používate naše rozhranie API, pripíšte nám odkaz.

Autentifikácia & sadzby

Pre všetky volania API potrebujete kľúč API. Získajte svoje vo svojom profilovej stránke (na prístup na túto stránku musíte mať účet a byť prihlásený).

Všetky koncové body API sú pod https://coinlib.io/api/v1. Na prístup k API použite GET.

Hodnotíme limit API na koncový bod a za hodinu. Všetky odpovede zahŕňajú zostávajúce požiadavky, ktoré môžete vykonať do začiatku nasledujúcej hodiny.

120 žiadostí/hodinu do /global
60 žiadostí/hodinu do /coinlist
180 žiadostí za hodinu na /coin

Vždy by ste mali zadať jednu požiadavku naraz, ak sa pokúsite vykonať paralelné požiadavky, vráti sa 429. Nakoniec nepoužívajte viacero kľúčov API.

Odpovede

Odpovede sú vo formáte JSON. Celé čísla (počet mincí, hodnosť, časové pečiatky) sa vrátia ako celé čísla. Desatinné čísla sú vrátené ako reťazce pomocou . ako desatinnej čiarky a môžu mať až 10 presných číslic.

Príklad chyby:

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

Koncové body

Štatistiky globálneho trhu

koncový bod:
/global

Požadované parametre:
key: API key

Voliteľné parametre:
pref: symbol na použitie pre ceny a iné trhové hodnoty. Predvolená hodnota je USD.

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

výsledok:

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

Zoznam mincí

koncový bod:
/coinlist

Požadované parametre:
key: API kľúč

Voliteľné parametre:
pref: symbol na použitie pre ceny a iné trhové hodnoty. Predvolená hodnota je USD.
page: celé číslo od 1. V súčasnosti vraciame 100 výsledkov na stránku, ale to sa môže bez varovania zmeniť.
order:

Na použitie v poradí (od prvého do posledného). rank_asc
Na použitie v poradí (od posledného k prvému). rank_desc
Pre objem 24 hodín (od nízkej po vysokú). volume_asc
Pre hlasitosť 24 hodín (od vysokej po nízku). volume_desc
Pre cenu (nízku až vysokú) použitie price_asc
Za cenu (od vysokej po nízku) použitie price_desc
Pre uvedený dátum (od nedávneho po staršie) použitie date_inserted_asc
Pre uvedený dátum (od staršieho po nedávne) použitie date_inserted_desc

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

výsledok:

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

Informácie o minciach

koncový bod:
/coin

Požadované parametre:
key: API kľúč
symbol: symbol jednej mince alebo zoznam symbolov oddelených čiarkami

Voliteľné parametre:
pref: symbol na použitie pre ceny a iné trhové hodnoty. Predvolená hodnota je USD.

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

výsledok:

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

Poznámky:
symbol: Vždy jedinečné.
show_symbol: Symbol, ktorý minca používa. Niektoré mince používajú rovnaký symbol ako iné mince.
total_volume_24h: Celkový objem pre všetky trhy, na ktorých sa táto minca podieľa, prevedený na váš pref mena.
markets: Ukážeme top 3 páry pre vybranú mincu. Ak sa obchoduje s vašou menou pref, potom je vždy zahrnutá ako prvá.
exchanges: Prvé 3 výmeny podľa objemu pre pár.

Pokročilé:
Jediným hovorom môžete získať informácie až za 10 mincí. Každá minca sa započítava do vašej kvóty. Uveďte zoznam symbolov oddelených čiarkami, napr.
https://coinlib.io/api/v1/coin?key=XXX&pref=EUR&symbol=BTC,ETH,XMR
Výsledok v tomto prípade vyzerá takto:

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