Coinlib API v1 BETA

Intro

Zpětná vazba k rozhraní API je vítána na adrese [email protected]. Přestože se jedná o BETA, myslíme si, že bude velmi stabilní. Navíc požadavky a odpovědi se nezmění, alespoň ne příliš.

Licence

Naše API můžete používat pod licencí Creative Commons Attribution-NonCommercial 3.0 Unported (CC BY-NC 3.0). Pokud na svém webu nebo v aplikaci používáte naše API, nezapomeňte nám připsat odkaz.

Autentizace & limity sazeb

Pro všechna volání API potřebujete klíč API. Získejte ten svůj ve svém profilová stránka (k přístupu na tuto stránku musíte mít účet a být přihlášeni).

Všechny koncové body API jsou pod https://coinlib.io/api/v1. Pro přístup k API použijte GET.

Omezujeme API na koncový bod a za hodinu. Všechny odpovědi zahrnují zbývající požadavky, které můžete provést do začátku další hodiny.

120 požadavků/hodinu na /global
60 požadavků/hodinu na /coinlist
180 požadavků/hodinu na /coin

Vždy byste měli vydávat jeden požadavek najednou, pokud se pokusíte provést paralelní požadavky, vrátí se 429. Nakonec nepoužívejte více klíčů API.

Odezvy

Odpovědi jsou v JSON. Celá čísla (počet mincí, hodnost, časová razítka) jsou vrácena jako celá čísla. Desetinná čísla jsou vrácena jako řetězce pomocí . jako desetinné čárky a mají až 10 přesných číslic.

Příklad chyby:

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

Koncové body

Statistiky globálního trhu

Koncový bod:
/global

Požadované parametry:
key: API key

Volitelné parametry:
pref: symbol k použití pro ceny a další tržní hodnoty. Výchozí hodnota je USD.

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

Výsledek:

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

Seznam mincí

Koncový bod:
/coinlist

Požadované parametry:
key: API klíč

Volitelné parametry:
pref: symbol k použití pro ceny a další tržní hodnoty. Výchozí hodnota je USD.
page: celé číslo, počínaje 1. Prozatím vracíme 100 výsledků na stránku, ale to se může bez varování změnit.
order:

Pro použití v pořadí (od prvního do posledního). rank_asc
Pro použití v pořadí (od posledního k prvnímu). rank_desc
Pro objem 24h (nízká až vysoká) použití volume_asc
Pro hlasitost 24h (vysoká až nízká). volume_desc
Pro cenu (nízká až vysoká) použití price_asc
Za cenu (od vysoké k nízké) použití price_desc
Pro uvedené datum (od nedávného po starší) použití date_inserted_asc
Pro uvedené datum (od staršího do nedávného) použití date_inserted_desc

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

Výsledek:

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

Informace o mincích

Koncový bod:
/coin

Požadované parametry:
key: API klíč
symbol: symbol jedné mince nebo seznam symbolů oddělených čárkou

Volitelné parametry:
pref: symbol k použití pro ceny a další tržní hodnoty. Výchozí hodnota je USD.

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

Výsledek:

        {
            "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, který mince používá. Některé mince používají stejný symbol jako jiné mince.
total_volume_24h: Celkový objem pro všechny trhy, na kterých se tato mince podílí, převedený na váš pref měna.
markets: Zobrazujeme 3 nejlepší páry pro vybranou minci. Pokud se s vaší měnou pref obchoduje, je vždy zahrnuta jako první.
exchanges: První 3 výměny podle objemu pro pár.

Pokročilý:
Jediným hovorem můžete získat informace až za 10 mincí. Každá mince se započítává do vaší kvóty. Uveďte seznam symbolů oddělených čárkami, tj.
https://coinlib.io/api/v1/coin?key=XXX&pref=EUR&symbol=BTC,ETH,XMR
Výsledek v tomto případě vypadá takto:

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