Coinlib API v1 БЕТА

Въведение

Обратната връзка за API е добре дошла на info+api@coinlib.io. Въпреки че това е БЕТА, ние смятаме, че ще бъде много стабилно. Освен това исканията и отговорите няма да се променят, поне не много.

Разрешително

Можете да използвате нашия API под лиценз Creative Commons Attribution-NonCommercial 3.0 Unported (CC BY-NC 3.0). Моля, уверете се, че ни кредитирате с връзка, ако използвате нашия API на вашия уебсайт или приложение.

Удостоверяване & лимити на скоростта

Имате нужда от API ключ за всички API повиквания. Вземете своя във вашата профилна страница (трябва да имате акаунт и да сте влезли, за да получите достъп до тази страница).

Всички крайни точки на API са под https://coinlib.io/api/v1. Използвайте GET за достъп до API.

Ограничаваме API за крайна точка и за час. Всички отговори включват оставащите заявки, които можете да направите до началото на следващия час.

120 заявки/час до /global
60 заявки/час до /coinlist
180 заявки/час до /coin

Винаги трябва да издавате една заявка в даден момент, ако се опитате да направите паралелни заявки, ще бъде върнато 429. И накрая, не използвайте множество API ключове.

Отговори

Отговорите са в JSON. Цели числа (брой монети, ранг, времеви печати) се връщат като цели числа. Десетичните числа се връщат като низове, като се използва . като десетична запетая и има до 10 прецизни цифри.

Пример за грешка:

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

Крайни точки

Статистика на световния пазар

крайна точка:
/global

Необходими параметри:
key: API key

Незадължителни параметри:
pref: символ, който да се използва за цени и други пазарни стойности. По подразбиране е USD.

пример:
https://coinlib.io/api/v1/global?key=XXX&pref=EUR

Резултат:

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

Списък с монети

крайна точка:
/coinlist

Необходими параметри:
key: API ключ

Незадължителни параметри:
pref: символ, който да се използва за цени и други пазарни стойности. По подразбиране е USD.
page: цяло число, започващо от 1. Засега връщаме 100 резултата на страница, но това може да се промени без предупреждение.
order:

Използване за ранг (от първи до последен). rank_asc
Използване за ранг (от последно до първо). rank_desc
За обем 24 часа (от ниска към висока) използвайте volume_asc
За обем 24 часа (висок към нисък) използвайте volume_desc
За цена (от ниска към висока) използвайте price_asc
За цена (висока към ниска) използвайте price_desc
За посочената дата (от скорошна към по-стара) употреба date_inserted_asc
За посочената дата (от по-стари до скорошни) използвайте date_inserted_desc

пример:
https://coinlib.io/api/v1/coinlist?key=XXX&pref=BTC&page=1&order=volume_desc

Резултат:

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

Информация за монети

крайна точка:
/coin

Необходими параметри:
key: API ключ
symbol: единичен символ на монета или разделен със запетая списък със символи

Незадължителни параметри:
pref: символ, който да се използва за цени и други пазарни стойности. По подразбиране е USD.

пример:
https://coinlib.io/api/v1/coin?key=XXX&pref=EUR&symbol=BTC

Резултат:

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

бележки:
symbol: Винаги уникален.
show_symbol: Символът, който монетата използва. Някои монети използват същия символ като други монети.
total_volume_24h: Общият обем за всички пазари, на които участва тази монета, конвертиран във вашия pref валута.
markets: Показваме първите 3 двойки за избраната монета. Ако вашата валута pref се търгува, тя винаги е включена първа.
exchanges: Топ 3 се разменят по обем за двойката.

Разширено:
Можете да получите информация за до 10 монети с едно обаждане. Всяка монета се брои спрямо вашата квота. Дайте разделен със запетая списък със символи, т.е.:
https://coinlib.io/api/v1/coin?key=XXX&pref=EUR&symbol=BTC,ETH,XMR
Резултатът в този случай изглежда така:

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