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.

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