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: символ для использования для цен и других рыночных значений. По умолчанию — доллары США.

Пример:
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: символ для использования для цен и других рыночных значений. По умолчанию — доллары США.
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: символ для использования для цен и других рыночных значений. По умолчанию — доллары США.

Пример:
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
        }