Coinlib API v1 БЕТА

вступление

Отзывы об API приветствуются по адресу [email protected]. Хотя это БЕТА, мы думаем, что она будет очень стабильной. При этом запросы и ответы не изменятся, по крайней мере, не сильно.

Лицензия

Вы можете использовать наш 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 на конечную точку и в час. Все ответы включают оставшиеся запросы, которые вы можете выполнить до начала следующего часа.

Вы всегда должны выполнять один запрос за раз, если вы попытаетесь выполнить параллельные запросы, будет возвращено 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: Пример:
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
        }