首页 知识 限时！解锁 Coinbase API 行情查询，掌握币圈先机！

限时！解锁 Coinbase API 行情查询，掌握币圈先机！

2025-03-06 29 次浏览 条评论

Coinbase API 行情查询

Coinbase 作为全球领先的加密货币交易平台之一，其提供的 API 接口为开发者和交易者提供了强大的行情数据查询能力。利用 Coinbase API，我们可以实时获取各种加密货币的市场价格、交易量、历史数据等关键信息，从而进行量化交易、数据分析、构建自动化交易系统等多种应用。本文将深入探讨 Coinbase API 的行情查询功能，并提供一些使用示例。

API 概述

Coinbase 提供多种 API 版本，以满足不同用户的需求。其中，Coinbase Pro API（现常被称为 Advanced Trade API）因其卓越的性能和丰富的功能而备受青睐。与基础 API 相比，Coinbase Pro API 提供了更高级的功能，包括实时市场数据流、深度订单簿访问以及对限价单、市价单、止损单等多种复杂订单类型的支持。这些特性使其成为专业交易者和机构投资者的理想选择。

要开始使用 Coinbase API，您需要一个有效的 Coinbase 账户，并且必须申请获得 API 密钥。API 密钥是访问 API 的凭证，它由三个关键部分组成：API 密钥本身（API Key）、API 密钥的签名（API Secret）以及安全口令（Passphrase）。API Key 用于标识您的身份，API Secret 用于对请求进行签名，确保请求的完整性和安全性，Passphrase 则作为额外的安全层，用于加密敏感数据。请务必以极其谨慎的态度保管这三个密钥，切勿将其泄露给任何第三方。密钥泄露可能导致您的账户被非法访问和资金损失。建议采用安全的密钥管理措施，例如使用硬件钱包或密钥管理系统来存储和保护您的 API 密钥。

Coinbase API 采用 RESTful 架构风格，这意味着它利用标准的 HTTP 请求方法来进行数据交互。常用的 HTTP 方法包括 GET、POST、PUT 和 DELETE，它们分别对应于数据的读取、创建、更新和删除操作。在加密货币行情查询的场景下，我们通常使用 GET 方法来获取实时的市场数据和历史交易信息。API 返回的数据格式通常为 JSON（JavaScript Object Notation），这是一种轻量级的数据交换格式，易于解析和处理。JSON 格式具有良好的可读性和跨平台兼容性，使其成为各种编程语言和应用程序之间进行数据传输的理想选择。您可以利用各种编程语言提供的 JSON 解析库来方便地提取和使用 API 返回的数据。

行情查询接口

Coinbase API 提供了丰富的行情查询接口，能够满足开发者对加密货币市场数据多样化的需求。以下是几个常用的接口，以及它们提供的关键数据：

  • /products : 获取所有可交易的产品列表。该接口返回的数据包含了交易所支持的所有交易对，例如 BTC-USD、ETH-BTC 等。除了交易对信息，它还提供了每个交易对的基础货币 (base currency)、报价货币 (quote currency)、最小交易单位 (base_min_size) 和最大交易单位 (base_max_size) 等详细信息。这些信息对于构建交易策略和风险控制至关重要。
  • /products/ /ticker : 获取指定交易对的实时行情数据。其中 需要替换为具体的交易对ID，例如 "BTC-USD"。此接口返回的数据包括：最新成交价 (price)、24 小时成交量 (volume)、24 小时最高价 (high_24h)、24 小时最低价 (low_24h)、以及当前最佳买入价 (best_bid) 和最佳卖出价 (best_ask)。这些数据是进行实时交易决策的重要依据。
  • /products/ /book : 获取指定交易对的订单簿信息。订单簿记录了当前市场上所有未成交的买单和卖单，按照价格由高到低和由低到高排列。通过指定 depth 参数，可以控制返回的订单簿深度，即显示多少个买单和卖单。订单簿数据对于分析市场深度、预测价格走势以及进行算法交易至关重要。该接口可以获取不同精度的订单簿信息， depth=1 只返回最佳买卖单， depth=2 或 depth=3 返回更深度的订单簿信息。
  • /products/ /trades : 获取指定交易对的最新成交记录。该接口返回的数据包括：成交时间 (time)、成交价 (price)、成交量 (size) 和买卖方向 (side)，side 可能为 "buy" 或 "sell"。通过分析历史成交记录，可以了解市场的实时交易活动，识别潜在的价格趋势，并评估市场情绪。
  • /products/ /candles : 获取指定交易对的历史K线数据。K线图是一种常用的技术分析工具，它以图形化的方式展示了价格在一段时间内的波动情况。该接口返回的数据包括：开盘价 (open)、最高价 (high)、最低价 (low)、收盘价 (close) 和成交量 (volume)。通过指定 granularity 参数，可以控制K线的时间间隔，例如 60 秒 (1 分钟)、300 秒 (5 分钟)、900 秒 (15 分钟)、3600 秒 (1 小时)、86400 秒 (1 天) 等。不同时间粒度的 K 线数据适用于不同时间尺度的交易策略和技术分析。

其中 是交易对的ID，必须使用交易所支持的格式，例如 "BTC-USD" 代表比特币兑美元， "ETH-BTC" 代表以太坊兑比特币。在使用这些 API 接口时，请务必参考 Coinbase 官方文档，了解具体的参数要求、速率限制和错误处理机制，以确保程序的稳定性和可靠性。

使用示例 (Python)

以下是一个使用 Python 语言调用 Coinbase API 获取 BTC-USD 最新交易对最新行情数据的示例，展示了如何通过简单的 HTTP 请求获取加密货币市场的实时信息。

import requests import

这个代码片段导入了必要的Python库。 requests 库用于发送HTTP请求，而 库用于处理从API返回的JSON格式数据。

api_url = "https://api.coinbase.com/v2/prices/BTC-USD/spot"

定义了Coinbase API的URL，该URL专门用于获取BTC-USD交易对的现货价格。 api_url 变量存储了这个地址，方便后续的调用。

try: response = requests.get(api_url) response.raise_for_status() # Raise HTTPError for bad responses (4xx or 5xx) except requests.exceptions.RequestException as e: print(f"请求失败: {e}") exit()

尝试发送GET请求到Coinbase API。 使用 try...except 块来捕获可能发生的网络异常，如连接错误或HTTP错误。 response.raise_for_status() 会检查HTTP响应状态码，如果状态码表示错误（4xx或5xx），则会引发异常，从而可以更好地处理API请求中的问题。 如果请求失败，会打印错误信息并退出程序。

data = response.()

将API返回的JSON格式数据解析为Python字典。 response.() 方法将响应内容转换为Python数据结构，便于访问和处理。

if "data" in data: price = data["data"]["amount"] currency = data["data"]["currency"] print(f"BTC-USD 的最新价格: {price} {currency}") else: print("无法获取价格信息")

检查响应数据中是否包含 "data" 字段。 如果存在，则从中提取价格和货币信息，并打印出来。 Coinbase API的响应通常包含一个 "data" 字段，其中包含实际的价格信息。 如果 "data" 字段不存在，则打印错误消息，表明无法获取价格信息。

API Endpoint

用于获取比特币兑美元 (BTC-USD) 交易对实时价格信息的API端点为： https://api.exchange.coinbase.com/products/BTC-USD/ticker 。

该端点提供的数据包括但不限于：

  • price : 当前的最新成交价。
  • size : 最新成交的交易量大小。
  • time : 最新成交的时间戳（ISO 8601格式）。
  • bid : 当前最高买入价。
  • ask : 当前最低卖出价。
  • volume : 过去24小时的交易总量。

这是一个公开的REST API端点，通常使用GET请求进行调用。无需身份验证即可访问基本数据，但建议查阅Coinbase Pro API文档，以了解更详细的信息，如速率限制和数据结构。开发者可以使用各种编程语言和工具（如Python的requests库，JavaScript的fetch API等）来访问此端点，并解析返回的JSON格式数据，以便在应用程序中实时显示或进一步分析比特币的价格动态。详细的API使用方法和错误代码说明可以在Coinbase官方开发者文档中找到。

发送 GET 请求

response = requests.get(url)

检查响应状态码

当与加密货币交易所或其他数据提供商的 API 交互时，检查响应状态码至关重要。状态码可以快速指示请求是否成功。常用的状态码 200 表示请求成功，而其他状态码，如 400 （错误请求）、 404 （未找到）或 500 （服务器内部错误），则表明出现了问题。务必处理这些错误情况以确保程序的健壮性。

以下是如何检查响应状态码并解析 JSON 数据的 Python 示例: 

import requests
import 

response = requests.get("https://api.exchange.com/products/BTC-USD/ticker") # 替换为实际的 API 端点

if response.status_code == 200:
    # 解析 JSON 数据
    try:
        data = .loads(response.text)
    except .JSONDecodeError:
        print("JSON 解码错误：无法解析 API 响应")
        exit() # 退出程序或执行其他错误处理

    # 提取关键信息
    try:
        price = data["price"]
        volume = data["volume_24h"]
        high = data["high_24h"]
        low = data["low_24h"]

        # 打印结果
        print(f"最新成交价: {price}")
        print(f"24 小时成交量: {volume}")
        print(f"24 小时最高价: {high}")
        print(f"24 小时最低价: {low}")

    except KeyError as e:
        print(f"KeyError: 缺少必需的字段: {e}")
        print(f"完整的API响应数据: {data}") # 可选: 打印整个响应以进行调试
        exit() # 退出程序或执行其他错误处理

else:
    print(f"请求失败，状态码: {response.status_code}")
    print(f"错误详情: {response.text}") # 显示服务器返回的错误消息

此示例首先使用 requests 库向一个假设的加密货币交易所 API 的 /products/BTC-USD/ticker 端点发送 GET 请求。需要用实际的API端点替换。如果请求成功（状态码为 200），则使用 .loads() 函数解析返回的 JSON 数据。代码会提取诸如最新成交价、24 小时交易量、最高价和最低价之类的信息，然后将它们打印到控制台。

为了增加代码的健壮性，加入了 try...except 块来处理潜在的 JSONDecodeError （如果API返回无效的JSON）和 KeyError （如果响应中缺少预期的字段）。在 except 块中，您可以打印错误消息、记录错误或采取其他适当的操作，例如重试请求或使用默认值。

如果请求失败（状态码不是 200），则打印错误消息和响应文本。响应文本可能包含有关失败原因的更多信息。

获取历史K线数据

在加密货币交易和分析中，历史K线数据扮演着至关重要的角色。它提供了过去一段时间内特定加密货币的价格走势信息，是技术分析、算法交易策略回测以及市场趋势预测的基础。以下是一个使用 Python 编程语言，通过 HTTP 请求获取 Coinbase Pro 交易所 BTC-USD 交易对历史 K 线数据的示例，并详细解释了每个步骤的含义和作用： 

import requests
import datetime

这段代码首先导入了两个必要的 Python 模块： requests 和 datetime 。

  • requests 模块是一个用于发送 HTTP 请求的库，可以方便地与 Web API 接口进行交互，获取数据。在这个例子中，我们将使用它向 Coinbase Pro 的 API 发送请求，获取 BTC-USD 的历史 K 线数据。
  • datetime 模块提供了处理日期和时间的功能，我们将使用它来指定要获取的历史数据的起始时间和结束时间，并将其转换为 API 要求的格式。

接下来，需要定义一个函数或者直接编写代码来构造 API 请求并处理返回的数据。 一个完整的示例将包括指定API endpoint，构造请求参数（如开始和结束时间），发送请求，以及解析返回的JSON数据并进行处理（例如，保存到CSV文件或者进行可视化分析）。 Coinbase Pro API的具体文档应该被参考，以确保请求的格式和参数符合其规范。 例如，API endpoint 可能类似于 https://api.pro.coinbase.com/products/BTC-USD/candles , 并且需要传递 start , end , 和 granularity 参数。

一个更完整的例子应该包括错误处理（例如，检查API返回的状态码），以及对返回数据的适当处理，例如将Unix时间戳转换为更易读的日期格式。 为了遵守API的使用条款，可能需要实现速率限制，以避免过度请求导致被屏蔽。

API Endpoint

url = "https://api.exchange.coinbase.com/products/BTC-USD/candles"

该API端点用于从Coinbase交易所获取BTC-USD交易对的历史K线数据（也称为蜡烛图数据）。 https://api.exchange.coinbase.com 是Coinbase Pro API的基础URL。 /products/BTC-USD/candles 指定了请求的具体资源路径，其中：

  • /products 表示获取产品相关信息。
  • /BTC-USD 指定了交易对，即比特币（BTC）兑美元（USD）。你可以替换为其他交易对，例如 ETH-USD 或 LTC-BTC，以获取相应交易对的数据。
  • /candles 表示获取K线数据。K线数据包含了指定时间间隔内的开盘价、最高价、最低价、收盘价和交易量等信息。

要使用此端点，你需要构造一个HTTP GET请求。可以添加额外的查询参数来指定返回K线数据的粒度 ( granularity ) 。粒度定义了每根K线代表的时间间隔，以秒为单位。 例如： granularity=60 代表每根K线代表1分钟的数据。常用的粒度包括 60 (1分钟), 300 (5分钟), 900 (15分钟), 3600 (1小时), 21600 (6小时), 86400 (1天)。

完整的请求URL可能如下所示：

https://api.exchange.coinbase.com/products/BTC-USD/candles?granularity=3600

该请求将返回过去一定时间段内，每小时的BTC-USD K线数据。请注意，Coinbase API有速率限制，你需要合理控制请求频率，避免触发速率限制。

定义参数

granularity = 60 # 粒度：60 秒 (1 分钟)。粒度定义了K线图中每个柱状图代表的时间间隔。在这里，我们将粒度设置为60秒，意味着每个K线柱代表一分钟内价格的变动情况。选择合适的粒度对于分析市场趋势至关重要，粒度越小，反映的数据越详细，但也可能包含更多的噪音。

now = datetime.datetime.now() # 获取当前时间。使用 Python 的 datetime 模块获取当前时间，这将作为我们数据请求的时间范围的基准。

end_time = now.isoformat() # 将当前时间转换为 ISO 8601 格式的字符串。ISO 8601 是一种国际标准日期和时间表示法，便于不同系统之间的数据交换。

start_time = (now - datetime.timedelta(minutes=60)).isoformat() # 获取过去1小时的时间，并转换为 ISO 8601 格式的字符串。使用 datetime.timedelta 函数从当前时间减去 60 分钟，从而得到起始时间。这种方式确保我们获取的是最近一小时的数据，方便进行实时分析。

params = { "granularity": granularity, "start": start_time, "end": end_time } # 创建一个包含所有参数的字典。这些参数将被用于API请求，用于指定所需的数据粒度和时间范围。 granularity 参数定义了K线图的粒度， start 和 end 参数定义了数据的起始和结束时间。

发送 GET 请求

response = requests.get(url, params=params)

检查响应状态码

HTTP 响应状态码是服务器在响应客户端请求时返回的三位数代码，用于指示请求是否成功。 200 OK 状态码表示请求已成功，服务器已成功处理了请求并返回了所需的数据。其他状态码，如 400 Bad Request 、 401 Unauthorized 、 403 Forbidden 、 404 Not Found 和 500 Internal Server Error 等，都表示请求失败，需要根据具体的状态码来诊断和解决问题。

当 response.status_code 等于 200 时，表示API请求成功。此时，可以使用 response.text 属性获取服务器返回的JSON格式数据，并使用 .loads() 函数将其解析为 Python 字典或列表，以便进一步处理。

.loads(response.text) 函数将 JSON 字符串转换为 Python 对象（通常是列表或字典）。如果JSON数据格式不正确，该函数会抛出 .JSONDecodeError 异常，因此在使用前最好进行错误处理。 

# 打印 K 线数据
for candle in data:
    timestamp = candle[0] # K线开始的时间戳（Unix时间戳，单位为秒）
    low = candle[1] # K线期间的最低价格
    high = candle[2] # K线期间的最高价格
    open_price = candle[3] # K线开始时的开盘价格
    close_price = candle[4] # K线结束时的收盘价格
    volume = candle[5] # K线期间的交易量 (通常以基础货币单位表示)

    dt_object = datetime.datetime.fromtimestamp(timestamp) # 将Unix时间戳转换为datetime对象，方便人类阅读

    print(f"时间: {dt_object}, 开盘价: {open_price}, 最高价: {high}, 最低价: {low}, 收盘价: {close_price}, 成交量: {volume}")

上述代码段详细解释了如何从K线数据列表中提取每个K线的信息，包括时间戳、最低价、最高价、开盘价、收盘价和交易量。时间戳通常以 Unix 时间戳格式提供，表示自 1970 年 1 月 1 日午夜（UTC/GMT 的午夜）以来经过的秒数。 使用 datetime.datetime.fromtimestamp() 函数可以将 Unix 时间戳转换为易于阅读的日期和时间对象。成交量的单位通常以基础货币来表示，例如，如果交易对是 BTC/USD，则成交量通常以 BTC 为单位。

datetime.datetime.fromtimestamp(timestamp) 函数将 Unix 时间戳转换为 Python 的 datetime 对象。 datetime 对象包含了年、月、日、时、分、秒等信息，方便进行日期和时间相关的操作和格式化输出。 需要注意的是， datetime 对象默认使用本地时区。 如果需要使用 UTC 时区，可以使用 datetime.datetime.utcfromtimestamp() 函数。

else:

如果 response.status_code 不是 200 ，则表示请求失败。 此时，应该打印错误信息，包括状态码和响应文本，以便诊断问题。 常见的错误包括：无效的 API 密钥、请求参数错误、服务器错误等。 response.text 属性包含了服务器返回的错误信息，可以帮助定位问题的根源。

print(f"请求失败，状态码: {response.status_code}") print(response.text)

这个示例使用了 granularity 参数来指定 K 线的时间间隔，这里设置为 60 秒（1 分钟）。 start 和 end 参数分别指定了数据的时间范围，这里获取过去 1 小时的数据。 API 返回的数据是一个列表，每个元素代表一个 K 线，包含了时间戳、开盘价、最高价、最低价、收盘价和成交量等信息。代码遍历 K 线数据，并将信息打印到控制台。需要注意的是，时间戳是Unix时间戳，需要进行转换才能方便阅读。 Granularity 参数的具体含义取决于交易所的API文档，常见的取值包括： 1m (1分钟), 5m (5分钟), 15m (15分钟), 30m (30分钟), 1h (1小时), 4h (4小时), 1d (1天), 1w (1周), 1M (1月) 等。

订单簿数据

订单簿是记录特定交易对（例如 BTC-USD）的买单（bid）和卖单（ask）的电子列表，它反映了市场参与者愿意买入和卖出的价格和数量。订单簿深度是衡量市场流动性的关键指标，越深的订单簿通常意味着更低的滑点。

以下是一个获取 BTC-USD 订单簿数据的示例，使用Python和 requests 库从交易所的API接口获取数据：

import requests

获取订单簿数据通常涉及以下步骤：

  • 确定交易所API： 选择一个提供API的加密货币交易所（例如：币安、Coinbase、OKX）。
  • 查找API文档： 查阅该交易所的API文档，找到获取订单簿数据的具体API endpoint。API文档会详细说明请求方法（GET或POST）、所需的参数（交易对、深度等）以及返回的数据格式（JSON）。
  • 构造API请求： 根据API文档构造HTTP请求。这通常包括设置URL、添加必要的参数，并设置请求头（例如，API密钥）。
  • 发送API请求： 使用 requests 库发送HTTP请求。
  • 解析API响应： 解析API响应，通常是JSON格式。提取订单簿数据，包括买单和卖单的价格和数量。
  • 数据处理： 对提取的订单簿数据进行进一步处理和分析，例如计算买卖价差、订单簿深度、加权平均价格等。

以下是一个更完整的示例代码框架（具体实现需要根据交易所API文档进行调整）： 

import requests
import 

def get_order_book(exchange_url, symbol, depth=20):
    """
    从交易所API获取订单簿数据。

    参数：
    exchange_url: 交易所API的URL。
    symbol: 交易对，例如 "BTC-USD"。
    depth: 返回的订单簿深度（买单和卖单的数量）。

    返回值：
    包含买单和卖单的字典。
    """
    try:
        url = f"{exchange_url}/orderbook?symbol={symbol}&depth={depth}"
        response = requests.get(url)
        response.raise_for_status()  # 检查HTTP状态码是否为200

        data = response.()
        return data

    except requests.exceptions.RequestException as e:
        print(f"API请求错误: {e}")
        return None
    except .JSONDecodeError as e:
        print(f"JSON解析错误: {e}")
        return None

# 示例用法 (需要替换为真实的交易所API URL和交易对)
exchange_url = "https://api.example-exchange.com"  # 替换为真实的交易所API URL
symbol = "BTC-USD"  # 交易对
order_book = get_order_book(exchange_url, symbol)

if order_book:
    # 解析订单簿数据
    bids = order_book.get("bids")  # 买单
    asks = order_book.get("asks")  # 卖单

    if bids and asks:
        print("买单:")
        for price, quantity in bids:
            print(f"  价格: {price}, 数量: {quantity}")

        print("\n卖单:")
        for price, quantity in asks:
            print(f"  价格: {price}, 数量: {quantity}")
    else:
        print("订单簿数据不完整。")

API Endpoint

API（应用程序编程接口）终结点是一个特定的URL，应用程序可以通过该URL与服务器进行通信，并请求特定的数据或执行特定的操作。在加密货币交易中，API终结点是访问交易所实时市场数据、下单、管理账户等的关键。

url = "https://api.exchange.coinbase.com/products/BTC-USD/book"

上述URL是一个示例，指向Coinbase交易所的API终结点，用于获取比特币（BTC）与美元（USD）交易对的订单簿数据。订单簿是交易所中所有挂单的集合，包括买单（Bid）和卖单（Ask），按照价格排序，反映了市场的买卖意愿和流动性。

详细分析：

  • https://api.exchange.coinbase.com : 这是Coinbase交易所API的根URL，所有API请求都以此为基础。不同的交易所会有不同的根URL。
  • /products : 表示我们要访问的是关于交易产品的信息。
  • /BTC-USD : 指定了要查询的交易对，这里是比特币兑美元。不同的交易对使用不同的符号表示。
  • /book : 指明我们请求的是订单簿数据。交易所通常会提供不同级别的订单簿深度，例如只显示最佳买卖价，或者显示更深层次的订单。

重要提示：在使用API终结点时，需要仔细阅读交易所的API文档，了解请求参数、响应格式、速率限制等信息。速率限制是指API允许的请求频率，超过限制可能会被暂时或永久禁止访问。为了安全起见，建议使用API密钥进行身份验证，并妥善保管API密钥，防止泄露。

定义订单簿深度参数

在加密货币交易中，订单簿深度是指订单簿中买单（bid）和卖单（ask）的数量和价格范围。通过调整 `depth` 参数，可以控制API返回的订单簿信息的详细程度。`depth` 参数直接影响你获取到的市场微观结构数据，从而影响你的交易策略和风险评估。

以下示例展示了如何通过 `params` 字典定义 `level` 参数，从而调整订单簿深度： 


params = {
    "level": 2  # 订单簿深度级别
}

参数说明：

  • level : 用于指定订单簿的深度级别。不同的级别代表返回的买单和卖单的数量不同。
  • level = 1 : 返回最佳买单（best bid）和最佳卖单（best ask）。这是最精简的订单簿信息，仅包含当前市场上最优的买入和卖出价格。适用于需要快速获取市场行情的情况。
  • level = 2 : 返回最多 50 个买单和 50 个卖单。提供更详细的订单簿信息，可以观察市场深度和流动性。适用于需要对市场进行初步分析的情况。
  • level = 3 : 返回完整的订单簿。提供市场上所有挂单信息，包括所有买单和卖单的价格和数量。适用于需要进行高频交易、算法交易或者深度市场分析的情况。请注意，返回完整订单簿可能会导致数据量较大，影响API响应速度。

选择合适的 `level` 取决于你的具体需求。例如，如果你的策略只需要关注最佳买卖价格，那么 `level = 1` 就足够了。如果你的策略需要更详细的订单簿信息，那么可以选择 `level = 2` 或 `level = 3`。需要注意的是，更高的 `level` 意味着更大的数据量，可能会影响API的响应速度和你的程序性能。在实际应用中，你需要根据你的策略需求和系统资源进行权衡。

发送 GET 请求

使用 Python 的 requests 库发送 GET 请求是与 Web 服务器交互的常见方式。 GET 请求主要用于从服务器检索数据，并且通常不会对服务器端数据进行修改。 以下代码展示了如何使用 requests.get() 函数来发送 GET 请求，并传递可选的查询参数。

response = requests.get(url, params=params)

其中：

  • url ：表示你要请求的 URL 地址，它是一个字符串。例如： "https://api.example.com/data" 。
  • params ：这是一个可选参数，用于传递查询字符串参数。 它是一个字典 ( dict ) 或字节序列，会被自动编码到 URL 中。 例如： params = {'key1': 'value1', 'key2': 'value2'} 会被编码成 ?key1=value1&key2=value2 并附加到 URL 之后。 如果 url 已经包含查询字符串， requests 库会自动合并 params 参数。
  • response ：这是一个 requests.Response 对象，包含了服务器返回的所有信息，例如状态码、头部信息和响应内容。 你可以通过 response.status_code 属性获取 HTTP 状态码（例如 200 表示成功，404 表示未找到），通过 response.headers 属性获取响应头，通过 response.text 属性获取响应内容的文本形式，以及通过 response.() 方法获取 JSON 格式的响应内容（如果服务器返回的是 JSON 数据）。

发送 GET 请求后，验证状态码至关重要，以确保请求成功。 常见做法是检查 response.status_code 是否为 200。 如果状态码不是 200，则表示请求可能失败，需要根据状态码采取相应的错误处理措施。

以下是一个完整的例子： 


import requests

url = "https://api.example.com/users"
params = {'page': 2, 'per_page': 10}

response = requests.get(url, params=params)

if response.status_code == 200:
    data = response.()
    print(data)
else:
    print(f"Request failed with status code: {response.status_code}")

在这个例子中，我们向 https://api.example.com/users 发送了一个 GET 请求，并传递了 page 和 per_page 两个参数。 如果请求成功，我们将响应的 JSON 数据打印出来；否则，我们将打印错误信息。

检查响应状态码

在接收到API响应后，首先要验证HTTP状态码，确认请求是否成功。状态码 200 表示成功。若状态码不为 200 ，则表示请求遇到问题，需要根据不同的状态码采取相应的措施。例如， 400 表示客户端错误， 404 表示资源未找到， 500 表示服务器内部错误。

if response.status_code == 200:
如果状态码是200，则继续解析响应内容。通常，加密货币交易所的API返回的数据格式为JSON，需要使用相应的库进行解析。
data = .loads(response.text) 

# 提取 bids 和 asks
# 从解析后的JSON数据中提取买单(bids)和卖单(asks)信息。买单表示用户愿意购买的价格和数量，卖单表示用户愿意出售的价格和数量。
bids = data["bids"]
asks = data["asks"]

# 打印 bids
# 遍历买单列表，并打印每个买单的价格和数量。价格代表买家愿意出的最高价，数量代表买家愿意购买的加密货币数量。
print("Bids:")
for bid in bids:
    price = bid[0] # 买单价格
    size = bid[1]  # 买单数量
    print(f"价格: {price}, 数量: {size}")

# 打印 asks
# 遍历卖单列表，并打印每个卖单的价格和数量。价格代表卖家愿意接受的最低价，数量代表卖家愿意出售的加密货币数量。
print("\nAsks:")
for ask in asks:
    price = ask[0] # 卖单价格
    size = ask[1] # 卖单数量
    print(f"价格: {price}, 数量: {size}")

else:
如果状态码不是200，则打印错误信息，包括状态码和响应内容。响应内容可能包含更详细的错误描述，有助于定位问题。
print(f"请求失败，状态码: {response.status_code}")
print(response.text)

此示例展示了如何获取订单簿数据。订单簿是市场供需关系的体现，包含买单和卖单信息。 level 参数控制返回订单簿的深度。订单簿深度指的是返回的买单和卖单的数量。深度越深，包含的订单信息越多，但数据量也越大。选择合适的订单簿深度取决于具体的应用场景。例如，高频交易可能需要更深的订单簿深度，而普通用户可能只需要较浅的订单簿深度。一些交易所允许通过API请求参数指定返回的订单簿的层级(level)，例如仅返回最优的几档买卖盘，以减少数据传输量。

注意事项

  • 速率限制： Coinbase API 对请求频率设置了严格的速率限制，旨在保护服务器稳定性和公平性。超出速率限制会导致 API 请求失败，并返回相应的错误代码。开发者应仔细阅读 Coinbase API 文档，了解不同 API 端点的具体速率限制策略。建议采用以下策略来避免超出速率限制：
    • 合理控制请求频率： 根据 API 文档，设置合理的请求间隔，避免短时间内发送大量请求。
    • 实施指数退避算法： 当收到速率限制错误时，不要立即重试，而是采用指数退避算法，逐渐增加重试间隔，以降低服务器压力。
    • 使用批量请求： 对于支持批量请求的 API 端点，尽可能将多个请求合并为一个，减少请求次数。
    • 监控 API 响应头： Coinbase API 会在响应头中返回剩余请求次数、重置时间等信息，开发者可以利用这些信息动态调整请求频率。
  • 身份验证： Coinbase API 提供了多种身份验证方法，以确保 API 请求的安全性。对于需要身份验证的 API 接口（例如，交易、账户管理等），需要在请求头中包含 API 密钥 (API Key)、签名 (Signature) 和口令 (Passphrase) 等信息。
    • API 密钥 (API Key)： 用于标识你的应用程序，可以在 Coinbase 开发者平台生成。
    • 签名 (Signature)： 用于验证请求的完整性，防止请求被篡改。签名是根据请求的 URL、时间戳、请求体等信息，使用你的 API 密钥进行 HMAC-SHA256 加密生成的。
    • 口令 (Passphrase)： 用于保护你的 API 密钥，防止未经授权的访问。在生成 API 密钥时，需要设置一个口令。
    具体的身份验证方法和签名生成方式，请务必参考 Coinbase API 文档。在代码中妥善保管你的 API 密钥和口令，避免泄露。
  • 错误处理： 在调用 Coinbase API 时，需要充分考虑各种可能出现的错误情况，并进行适当的错误处理。常见的错误包括网络错误 (例如，连接超时、DNS 解析失败)、API 错误 (例如，无效的 API 密钥、权限不足、参数错误) 等。
    • 网络错误： 使用 try-except 语句捕获网络异常，并进行重试或提示用户。
    • API 错误： 解析 API 响应中的错误代码和错误信息，根据错误类型进行相应的处理。例如，对于无效的 API 密钥错误，可以提示用户检查 API 密钥是否正确；对于权限不足错误，可以提示用户申请相应的权限。
    • 日志记录： 将错误信息记录到日志文件中，方便排查问题。
  • 数据精度： Coinbase API 返回的数字货币价格、交易量等数据精度可能存在一定差异，尤其是在高波动性时期。开发者需要根据实际需求，对数据进行适当的处理和转换，例如，使用 Decimal 类型进行精确计算，避免浮点数精度问题。同时，注意不同 API 端点返回的数据单位和精度可能不同，需要仔细阅读 API 文档，确保数据的一致性。

Coinbase API 为开发者提供了强大的行情查询能力，可以用于构建各种加密货币应用。通过合理使用 API 接口，我们可以获取实时的市场数据，进行量化交易和数据分析。 在使用 API 时，请务必仔细阅读 Coinbase API 文档，了解 API 的使用方法和注意事项。

Bitget手续费薅羊毛秘籍：不看亏大了！🚀 Bybit vs Gate.io：终极加密货币交易平台对决！选择哪个？
相关内容