Coinlib API v1 测试版

介绍

欢迎通过 info+api@coinlib.io 提供有关 API 的反馈。虽然这是一个测试版，但我们认为它会非常稳定。此外，请求和响应不会改变，至少不会改变很多。

执照

您可以在 Creative Commons Attribution-NonCommercial 3.0 Unported (CC BY-NC 3.0) 许可下使用我们的 API。如果您在您的网站或应用程序上使用我们的 API，请确保您向我们提供链接。

认证与速率限制

所有 API 调用都需要一个 API 密钥。在您的个人资料页中获取您的（您需要有一个帐户并登录才能访问此页面）。

所有 API 端点都在 https://coinlib.io/api/v1 下。使用 GET 访问 API。

我们对每个端点和每小时的 API 进行速率限制。所有响应都包括您可以在下一小时开始之前执行的 remaining 请求。

/global 120 个请求/小时
/coinlist 60 个请求/小时
/coin 180 个请求/小时

您应该始终一次发出一个请求，如果您尝试执行并行请求，将返回 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
        }