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.

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